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WEA, ZAUR. 


内 容 所 要 


本 书 全 面 介 绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概念 ， 并 详 
细 讲 解 如 何 运用 现代 设计 原则 使 用 Go 语言 构建 Web 应 用 。 本 书 通 过 大 量 
的 实例 介绍 核心 概念 《如 处 理 请 求 和 发 送 啊 应 、 模 板 引 车 和 数据 持久 
化 ) ， 并 深入 讨论 更 多 高 级 主题 “如 并 发 、Web 应 用 程序 测试 以 及 部 闭 
到 标准 系统 服务 上 融和 PaaS 提 供 商 〉。 


本 书 以 一 个 网 络 论坛 为 例 ， 讲 解 如 何 使 用 请 求 处 理 器 、 多 路 复 用 
器 、 模 板 引 擎 、 存 储 系统 等 核心 组 件 构建 一 个 Go Web 应 用 ， 然 后 在 这 
一 应 用 的 基础 上 上， 构建 出 相应 的 web 服务 。 值 得 一 提 的 是 ， 本 书 在 介绍 
Go Web 开 发 方法 时 ， 基 本 上 只 用 到 Go 语言 自 带 的 标准 库 ， 而 不 会 用 到 
任何 特定 的 Web 框 架 ， 读 者 学 到 的 知识 将 不 会 局 限于 特定 的 框架 ， 即 使 
将 来 需要 用 到 现成 的 框架 或 者 自行 构建 框架 ， 仍 然 会 从 本 书 中 获 益 。 本 
书 除 了 讲解 具体 的 Web 开 发 方法 ， 还 介绍 如 何 对 Go Web 应 用 进行 测 
试 ， 如 何 使 用 Go 的 并 发 特性 提高 Web 应 用 的 性 能 ， 以 及 如 何在 Heroku、 
Google App Engine. Digital Ocean 等 云 平 台 上 部 署 Go WebM H; 此外， 
书 中 还 传授 一 些 Go Web 开 发 方面 的 经 验 和 提示 。 这 些 重 要 的 实践 知识 
将 帮助 读者 快速 成 为 真正 具有 生产 力 的 Go Web 开 发 者 。 


























阅读 本 书 需要 读者 具备 基本 的 Go 语言 编程 技能 并 掌握 Go 语言 的 语 
法 。 本 书 适合 所 有 想 用 Go 语言 进行 Web 开 发 的 读者 阅读 ， 无 论 是 Web 开 
发 的 初学 者 还 是 入 行 已 久 的 开 友 者 都 会 在 阅读 本 书 的 过 程 中 有 所 收获 。 


译 者 记事 





随 着 近年 来 Web 开 发 的 盛行 ， 很 多 相关 书籍 也 随 之 如 雨后春笋 般 出 
现 ， 然 而 在 这 些 书 籍 当中 ， 绝 大 多 数 书籍 都 只 关注 表面 的 实现 代码 ， 而 
对 代码 背后 的 技术 原理 却 少 有 提 及 。 读 者 在 看 这 类 书籍 时 ， 虽 然 可 以 学 
到 某 个 框架 或 者 某 个 库 的 API， 并 根据 书 中 给 出 的 代码 搭建 出 一 个 个 演 
示 程 序 (demo) ， 但 是 对 隐藏 在 这 些 代码 之 下 的 原理 却 一 无 所 知 。 这 
种 停留 在 表面 的 理解 一 旦 离开 了 书本 的 指导 ， 就 会 让 人 感到 寸步 难 行 ， 
不 知 所 措 。 


本 书 的 独特 之 处 在 于 ， 它 抛 开 了 现 有 的 所 有 Go Web 框 架 ， 仅 仅 通 
过 Go 语言 内 置 的 标准 库 来 展示 如 何 去 构 建 一 个 web 应 用 或 web 服务。 这 
样 做 的 好 处 是 ， 无 论 将 来 读者 是 使 用 这 些 标 准 库 来 构建 Web 应 用 ， 还 是 
使 用 现成 的 框架 去 构建 Web 应 用 ， 又 或 者 使 用 自己 建造 的 框架 去 构建 
Web 应 用 ， 本 书 介 绍 的 知识 都 是 非常 有 用 的 : 如 果 使 用 的 是 现成 的 框 
染 ， 那 么 这 些 框架 的 内 部 实现 通常 就 是 由 本 书 介绍 的 Go 标准 库 构 建 
A; 如 果 选 择 自 建 框架 ， 那 么 将 有 很 大 概率 会 用 到 本 书 介绍 的 Go 标准 
库 。 因 此 ， 不 论 在 何 种 情况 下 ， 本 书 对 于 构建 Go Web 应 用 都 是 非常 有 
帮助 的 。 





本 书 的 另 一 个 优点 是 ， 它 在 介绍 Web 应 用 开发 技术 的 同时 ， 也 介绍 
了 隐藏 在 这 些 技术 背后 的 基础 知识 。 比 如 ， 在 介绍 Web 处 理 器 
Chandler) 的 创建 方法 之 前 ， 本 书 就 先 深 入 浅 出 地 介绍 了 HTTP 协 议 ， 
然后 才 说 明 具 体 的 请 求 处 理 方 法 以 及 啊 应 返回 方法 ; 又 比如 说 ， 在 介绍 





会 话 (session) 技术 时 ， 本 书 就 先 说 明了 HTTP 协 议 的 无 状态 性 质 ， 然 
后 才 说 明 如 何 使 用 会 话 去 解决 这 一 问题 ， 类 似 的 例子 在 书 里 面 还 有 很 
多 ， 不 一 而 足 。 对 刚 开 始 接触 web 开发 的 读者 来 说 ， 本 书 这 种 “ 知 其 
然 ， 也 知 其 所 以 然 ” 的 教授 方式 能 够 让 读者 打 好 Web 开 发 的 基础 ， 从 而 
达到 事半功倍 的 效果 ; 此 外 ， 对 那些 已 经 有 一 定 Web 开 发 经 验 的 读者 来 
说 ， 本 书 将 在 介绍 Go Web 开 及 方法 的 同时 ， 帮 助 读者 回顾 和 巩固 Web 
开发 的 相关 基础 知识 ， 并 厌 此 成 为 更 好 的 Web 开 发 者 。 








综 上 所 述 ， 我 认为 这 本 书 对 所 有 关心 Web 开 发 的 人 来 说 ， 痢 是 非常 
值得 一 读 的 一 一 无 论 读者 使 用 的 是 Go 语言 还 是 其 他 语言 、X 框 架 还 是 Y 
框架 ， 无 论 读者 是 Web 开 发 的 初学 者 还 是 入 行 已 久 的 开发 者 ， 应 该 都 会 
在 阅读 本 书 的 过 程 中 有 所 收获 。 





关于 本 书 的 翻 详 


这 本 《Go Web 编 程 》 是 我 的 第 二 部 译作 ， 在 翻译 第 一 部 译作 
《Redis 实 战 》 的 时 候 ， 因 为 受 经 验 、 知 识 以 及 时 间 等 条 件 限 制 ， 我 只 
能 把 时 间 尽 量 花 在 保证 译文 的 准确 性 上 ， 但 是 对 于 译文 本 身 的 可 读 性 却 
未 能 有 太 多 的 关注 。 这 次 在 翻译 这 本 《Go Web 编 程 》 的 过 程 中 ， 我 给 
目 己 订立 了 更 高 的 目标 ， 那 就 是 ， 在 保证 译文 正确 性 的 前 提 下 ， 通 过 合 
理 的 用 词 坦 句 ， 让 译文 更 符合 中 文 表 达 方 式 ， 并 且 更 具 表 现 力 。 





以 本 书 的 前 言 原文 为 例 ， 其 中 就 有 一 句 “My own journey in 
developing applications for the web started around the same time, in the mid- 
1990s”， 这 人 句 话 的 原意 是 说 作者 的 Web 开 发 生涯 跟 万 维 网 的 发 展 轨迹 下 
好 重合 ， 因 此 把 它 单纯 地 译 为 “本 人 的 Web 应 用 开发 生涯 也 是 从 20 世 纪 
90 年 代 中 期 开始 .…...” 是 完全 没有 问题 的 ， 但 是 通过 在 句子 前 面 添加 “无 
独 有 偶 ” 一 词 来 与 around the same time” 的 翻译 “也 是 ”相互 呼应 ， 就 会 一 
下 子 给 译文 带 来 画龙点睛 的 效果 :“ 无 独 有 侦 ， 本 人 的 Web 应 用 开发 生 
涯 也 是 从 20 世 纪 90 年 代 中 期 开始 .…...” 











继续 以 前 言 为 例 ， 在 这 篇 文章 的 原文 当中 ， 出 现 了 不 少 常见 的 瑞 文 
短语 和 词汇 ， 这 些 短语 和 词汇 通常 都 有 一 个 正确 、 第 见 并 且 平 良 的 翻 
译 ， 但 是 本 书 却 抛 弃 了 这 些 翻 译 ， 转 而 选择 了 更 准确 也 更 有 表现 力 的 译 
法 。 比 如 说 ，“Writing web applications has changed dramatically over the 
years” 中 的 “changed dramatically” 没 有 直译 为 “发 生 了 戏剧 性 的 变化 ”， 而 
是 翻译 为 “发 生 了 翻天 窗 地 的 变化 ”; “Almost as soon as the first web 


applications were written, web application frameworks appeared” 中 的 “were 


written” 和 “appeared” 没 有 直译 为 “被 编写 出 来 之 后 ”以 及 “出 现 ”， 而 是 分 
别 翻 译 为 “内 亮 登场 ?和 “应 运 而 生 ”， 前 者 突出 了 Web 应 用 的 出 现 对 于 互 
联网 的 巨大 改变 ， 而 后 者 则 突出 了 Web 应 用 和 Web 框 架 之 间 相 辅 相 成 的 
关系 。 类 似 的 例 季 还 有 很 多 很 多 ， 并 且 它 们 不 仅 出 现在 了 前 言 里 ， 还 出 
现在 了 本 书 的 正文 当中 。 











当然 ， 提 高 译文 的 可 读 性 并 不 是 一 件 一 跃 而 就 的 事 。 为 了 让 译文 更 
有 “中 文 味 ”， 本 书 的 大 多 数 译文 都 已 三 易 其 稿 ， 有 时 候 仅 仅 为 了 挑选 出 
一 个 更 恰当 的 词语 或 成 语 ， 就 不 得 不 对 着 词典 推 殴 半 天 。 这 本 书 的 翻译 
从 2016 年 8 月 开始 ， 到 2017 年 8 月 交 稿 ， 整 整 跨越 了 一 年 时 间 ， 其 中 翻译 
原文 和 润色 译文 两 项 工作 花费 的 时 间 可 谓 各 占 一 半 。 如 果 读 者 能 够 从 译 
文 的 字里行间 感受 到 这 种 润 物 细 无 声 的 优化 ， 那 将 是 对 本 人 翻译 工作 最 
好 的 肯定 。 








另外 ， 因 为 这 是 一 本 使 用 Go 语言 标准 库 进 行 Web 开 发 的 书 ， 所 以 对 
Go Web 开 发 相关 标准 库 的 理解 程度 将 是 能 个 准确 地 翻译 本 书 技术 内 容 
的 关键 。 为 了 进一步 熟悉 本 书 用 到 的 标准 库 ， 本 人 通读 了 书 中 用 到 的 各 
个 标准 库 的 文档 ， 阅 读 了 其 中 部 分 标准 库 的 源码 ， 并 且 因 为 有 时 候 “ 好 
记性 比 不 上 烂 笔 小 ”， 所 以 本 人 还 翻译 了 其 中 一 部 分 标准 库 文档 ， 力 求 
在 尽 可 能 掌握 标准 库 细 市 的 情况 下 ， 再 进行 翻译 ， 尺 量 做 到 知 其 然 也 知 
其 所 以 然 ， 而 不 是 单纯 地 根据 纸 面 上 的 文字 和 代码 进行 翻译 。 














最 后 ， 在 翻译 本 书 的 过 程 中 ， 本 人 也 发 现 了 原著 中 大 大 小 小 数 十 个 
bug， 并 在 译文 中 一 一 进行 了 修正 。 综 上 所 述 ， 读 者 看 到 的 这 个 译本 从 
菏 个 角度 来 说 将 比 原 车 更 准确 也 更 易 读 。 这 也 是 我 一 直 以 来 在 实践 翻译 
工作 时 的 信念 一 一 译作 不 应 该 是 原著 的 “劣化 版 ”， 而 是 应 该 以 * 育 出 于 








WT HEP E Hy SRE eo PR, BBR — IF ANE APE 
事 ， 但 每 一 个 合格 的 译 者 都 应 该 以 此 为 目标 ， 不 断 否 斗 。 


读者 服务 网 站 


为 了 更 好 地 服务 本 书 读 者 ， 本 人 专门 为 本 书 搭建 了 读者 服务 网 站 
http:/gwpcn.com。 读 者 只 要 访问 这 个 网 站 ， 就 可 以 查看 到 与 本 书 有 关 的 
各 项 信息 ， 如 本 书 的 简介 、 目 录 、 试 读 内 容 、 作 译 者 介绍 、 勤 误 信 息 、 
购买 地 址 以 及 源 代 码 下 载 地 址 等 。 








除 此 之 外 ， 正 如 之 前 所 说 ， 本 人 在 翻译 本 书 的 过 程 中 也 翻译 了 一 部 
分 Go 标准 库 的 文档 ， 这 些 文 档 可 以 通过 地 址 http:/Vcngolib.com 碍 看 。 
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除了 已 出 版 的 两 本 作品 之 外 ， 他 还 创作 和 翻译 了 《Go 标准 库 中 文 
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自 互 联网 从 20 世 纪 90 年 代 中 期 诞生 以 来 ，Web 应 用 就 以 这 样 或 那样 
的 方式 存在 了 。 昌 然 Web 应 用 在 最 初 只 能 传输 静态 网 页 ， 但 它 很 快 就 升 
级 和 演变 成 了 一 个 令 人 眼花 综 乱 、 能 够 传输 各 种 数据 以 及 实现 各 种 功能 
的 动态 系统 。 无 独 有 偶 ， 本 人 也 是 从 20 世 纪 90 年 代 中 期 开始 接触 web 应 
用 开发 的 ， 在 迄今 为 止 的 职业 生涯 当中 ， 我 把 大 部 分 时 间 都 花费 在 了 大 
规模 Web 应 用 的 设计 、 开 发 以 及 团队 管理 上 面 ， 并 且 在 这 期 间 还 使 用 过 
多 种 不 同 的 编程 语言 和 框架 ， 其 中 包括 Java、Ruby、Node.js、PHP、 
Perl、Elixir 甚 至 是 Smalltalk。 





几 年 前 ， 我 因为 一 次 偶然 的 机 会 接触 到 了 Go 语言 ， 并 迅速 被 它 的 
简单 和 清 更 直率 所 吸引 ， 而 当 我 意识 到 只 使 用 Go 的 标准 库 就 可 以 快速 
地 构建 完整 、 高 效 并 且 可 扩展 的 Web 应 用 和 服务 时 ， 我 对 Go 的 喜爱 又 更 
进 了 了 一步。 使 用 Go 语言 编写 的 代码 不 仅 易 履 、 和 直截了当 ， 而 且 还 能 够 
快速 、 简 单 地 编译 成 一 个 独立 的 可 部 普 二 进 制 文件 。 更 关键 的 是 ， 我 不 
必 投 入 大 量 服 务 器 就 可 以 让 上 自己 的 Web 应 用 变 得 可 扩展 且 有 具备 生 产能 
力 。 很 目 然 地 ， 所 有 的 这 些 优 点 都 使 Go 成 为 了 我 在 Web 应 用 开发 方面 最 
新 的 心头 好 语言 。 

















从 当初 传输 静态 内 容 到 现在 通过 HTTP 传 输 动 态 数据 ， 从 当初 使 用 
服务 器 传输 HTML 内容， 到 现在 使 用 客户 端 单 页 应 用 去 处 理 通过 HTTP 
传输 的 JSON 数 据 ，Web 应 用 的 开发 方式 已 经 发 生 了 翻天 履 地 的 变化 。 
几乎 就 在 Web 应 用 闪 亮 登场 的 同时 ，Web 框 架 也 应 运 而 生 ， 并 使 程序 员 





可 以 更 为 容易 地 去 开发 Web 应 用 。 这 二 十 多 年 以 来 ， 绝 大 多 数 编程 语言 
都 会 有 至少 一 个 Web 应 用 框架 ， 其 中 很 多 语言 甚至 会 有 一 大 堆 框 架 可 
用 ， 而 当今 出 现 的 绝 大 多 数 应 用 都 是 Web 应 用 。 








尽管 Web 应 用 框架 的 风靡 使 开发 Web 应 用 变 得 更 加 容易 了 ， 但 这 些 
框 染 在 带 来 方便 的 同时 也 隐藏 了 大 量 的 细 市 一 一 Web 应 用 开发 者 对 于 万 
维 网 的 运作 方式 知之 其 少 甚 至 一 窟 不 通 ， 这 样 的 情况 正在 变 得 越 来 越 第 
见 。 幸 运 的 是 ， 通 过 Go 语言 ， 我 发 现 了 一 种 正确 地 教授 Web 应 用 开发 基 
础 知识 的 绝 佳 工具 ， 它 能 够 让 Web 应 用 开发 重新 回 到 简单 直接 的 状态 : 
程序 需要 考虑 的 就 是 如 何 处 理 HTTP 协 议 ， 以 及 如 何 通 过 HTTP 协 议 传输 
内 容 和 数据 ， 并 且 满 足 这 两 个 要 求 只 需要 用 到 Go 语言 本 身 提供 的 工具 
一 一 个 需要 用 到 外 部 库 ， 也 不 需要 用 到 外 部 的 依赖 。 























在 拿 定 注意 之 后 ， 我 就 向 Manning 出 版 社 提交 了 一 个 撰写 Go 语言 编 
程 书籍 的 构思 ， 这 个 构思 关注 的 是 如 何在 只 使 用 标准 库 的 情况 下 ， 癌 读 
者 传授 从 零 开始 构建 Web 应 用 的 方法 ， 而 Manning 出 版 社 也 很 快 就 同意 
了 我 的 构思 并 开局 了 这 个 项 目 。 尽 管 本 书 的 撰写 工作 持续 了 一 段 时 间 才 
得 以 完成 ， 但 是 在 写作 的 过 程 中 ， 抢 先 预览 版 各 来 的 反馈 总 是 不 断 地 去 
舞 关 我。 最后， 我 希望 读者 能 够 像 我 译 受 创作 本 书 的 过 程 一 样 ， 有 至 受 阅 
读本 书 的 过 程 ， 并 且 在 这 个 过 程 中 能 够 有 所 收获 。 











致谢 


本 书 最 初 的 想法 是 在 只 使 用 标准 库 的 情况 下 教授 基本 的 Go Web 编 
程 知 识 。 说 实在 的 ， 刚 开始 的 时 候 我 并 不 确定 这 个 想法 是 人 否 能 够 行 得 
通 ， 但 那些 花费 目 己 血汗 钱 来 购买 本 书 抢先 预 哆 版 的 读者 给 了 我 或 励 和 
动力 来 实现 这 个 想法 ， 因 此 在 这 里 我 要 问 我 的 读者 们 致 以 减 妇 的 感谢 ! 














写 书 是 一 项 团队 协作 活动 ， 尽 管 本 书 的 封面 上 只 记载 了 我 一 个 人 的 
字 ， 但 实际 上 大 量 幕后 人 员 也 为 这 本 书 付出 了 自己 的 心血 ， 他 们 分 别 














e Marina Michaels， 来 目地 球 另 一 侧 的 一 位 勤务 且 高 效 的 编辑 ， 她 总 
是 不 知 疲倦 地 配合 我 的 工作 ， 并 且 为 了 我 们 之 间 巨 大 的 时 差 而 不 断 
地 调整 自己 的 日 程 表 ; 





。 Manning 出 版 社 的 相关 工作 人 员 : 文字 编辑 Liz Welch 和 校对 
Elizabeth Martin， 他 们 的 火眼金睛 让 错误 无 处 可 藏 ， 负 责 营 销 和 推 
广 本 书 的 Candace Gillhoolley 和 Ana Romac， 以 及 将 我 的 原稿 变 为 本 
书 的 Kevin Sullivan 和 Janet Vail; 


e Jimmy Frasch6 对 我 的 原稿 进行 了 一 次 完整 的 技术 校对 ， 而 我 的 审 稿 
人 Alex Jacinto. Alexander Schwartz. Benoit Benedetti, Brian 
Cooksey. Doug Sparling. Ferdinando Santacroce, Gualtiero Testa, 
Harry Shaun Lippy. James Tyo, Jeff Lim, Lee Brandt. Mike 
Bright. Quintin Smith, Rebecca Jones. Ryan Pulling. Sam Zaydel 和 


Wes Shaddix 则 在 撰写 原稿 的 4 个 阶段 中 为 我 提供 了 大 量 有 价值 的 反 


EN 
人 馈 ; 


。 这 本 书 的 抢先 预览 版 一 经 释 出 ， 我 在 新 加 坡 Go 社 区 的 朋友 们 就 迫 
不 及 符 地 把 它 癌 全 世界 广 而 告 之 了 ， 特 别 值得 一 提 的 是 Kai 
Hendry， 他 为 本 书 制作 了 一 个 详细 的 评论 视频 。 





另外 ， 我 还 要 感谢 Go 的 创造 者 Robert Griesemer、Rob Pike 和 Ken 
Thompson， 以 及 net/http . html/template 等 web 标准 库 的 开发 者 ， 
特别 是 Brad Fitzpatrick， 没 有 他 们 的 辛勤 付出 ， 这 本 书 束 不 可 能 出 现 。 


最 后 ， 也 是 最 必 不 可 少 的 ， 我 要 感谢 我 的 家 人 ， 包 括 我 杀 爱 的 妻子 
Wooi Ying， 以 及 在 身高 方面 后 来 居 上 的 我 的 儿子 Kai Wen。 我 希望 自己 
能 够 通过 创作 这 本 书 给 他 带 来 启发 ， 我 也 希望 他 会 自豪 地 阅读 这 本 书 ， 
并 从 中 有 所 收获 。 


ARTA 


本 书 将 完整 地 介绍 使 用 Go 语言 开发 Web 应 用 所 需 的 全 部 基本 概念 ， 
并 且 在 这 个 过 程 中 只 使 用 Go 语言 自 带 的 标准 库 。 尽 管 本 书 的 部 分 章节 
会 对 其 他 库 以 及 其 他 主题 进行 讨论 ， 比 如 如 何 测试 Web 应 用 以 及 如 何 部 
署 Web 应 用 ， 但 本 书 的 主要 目的 还 是 教 读者 如 何在 只 使 用 Go 标准 库 的 情 
况 下 进行 Web 开 发 。 








本 书 要 求 读者 具备 基本 的 Go 编程 技能 并 掌握 Go 语言 的 语法 。 如 果 
读者 不 具备 这 些 知 识 ， 可 以 阅读 由 William Kennedy, Brian Ketelsen 和 
Erik St. Martin 创 作 的 Go in Action 叫 一 书 ， 该 书 也 是 由 Manning 出 版 社 出 
版 的 。 由 Addison-Wesley 出 版 社 出 版 、Alan Donovan 和 Brian Kernighan 
创作 的 The Go Programming Language (站 也 是 一 本 值得 一 读 的 好 书 。 除 
了 以 上 提 到 的 两 本 书 之 外 ， 网 上 也 有 非常 多 免费 的 Go 教程 可 供 浏 览 ， 
比如 ，Go 官 方 网 站 的 《Go 入 门 教程 》 (A Tour of Go) 

Chttp://tour.golang.org/) 就 是 一 个 很 棒 的 例子 。 





内 容 编排 


本 书 由 10 章 和 一 个 附录 组 成 。 


第 1 间 会 介绍 使 用 Go 开发 Web 应 用 的 方法 ， 并 并 述 这 种 做 法 的 优点 
所 在 。 除 此 之 外 ， 本 章 还 会 对 HTTP 协 议 等 构成 Web 应 用 的 关键 概念 做 
深入 浅 出 的 介绍 。 





第 2 章 会 以 一 步 一 个 脚印 的 方式 ， 市 领 读者 去 构建 一 个 简单 的 网 上 
论坛 ， 以 此 来 向 读者 展示 如 何 使 用 Go 构建 一 个 典型 的 Web 应 用 。 


第 3 章 会 更 加 详细 地 展示 使 用 net/http 包 接收 HTTP 请 求 的 方法 。 读 者 
将 学 会 如 何 编写 Go Web 服 务 器 监听 HTTP 请 求 ， 以 及 如 何 使 用 处 理 器 和 
处 理 器 函数 处 理 这 些 请 求 。 


第 4 章 会 继续 介绍 处 理 HTTP 请 求 的 相关 细节 ， 重 点 讲述 Go 是 如 何 
处 理 请 求 并 返回 啊 应 的 。 除 此 之 外 ， 读 者 还 将 学 会 如 何 从 HTML 表 单 中 
获取 数据 以 及 如 何 使 用 cookie。 


第 5 童 将 会 介绍 由 text/template 库 和 html/template 库 组 成 的 
Go 模板 引擎 。 读 者 将 会 看 到 Go 提供 的 各 种 模板 机 制 ， 并 学 会 如 何 使 用 
Go 的 布局 (layout) 。 





第 6 章 将 会 对 Go 的 存储 策略 进行 讨论 。 读 者 将 学 会 如 何 通过 结构 将 
数据 存储 到 内 存 里 面 ， 如 何 通过 CSV 格 式 以 及 gob 二 进 制 格式 将 数据 存 
储 到 文件 系统 里 面 ， 以 及 如 何 通 过 SQL 和 SQL 映射 句 去 访问 关系 数据 


PEs 


第 7 章 将 展示 使 用 Go 语言 构建 Web 服 务 的 方法 。 读 者 不 仅 会 学 到 如 
何 使 用 Go 语言 构建 一 个 简单 的 Web 服务 ， 还 会 学 到 如 何 使 用 Go 语言 创 
建 并 分 析 XML 数 据 和 JSON 数 据 。 





第 8 章 将 回 读 者 传授 在 不 同 层级 中 测试 Go Web 应 用 的 不 同方 法 ， 其 
中 包括 单元 测试 、 基 准 测 试 以 及 HTTP 测 试 ， 除 此 之 外 ， 这 一 章 还 会 简 
单 介 绍 几 个 第 三 方 测试 库 。 


第 9 章 会 介绍 在 Web 应 用 中 使 用 Go 语言 的 并 发 特性 的 方法 。 读 者 将 
会 了 解 到 Go 语言 的 各 个 并 有 特性 ， 并 学 会 如 何 使 用 这 些 特 性 提高 一 个 
图 像 生 成 Web 应 用 的 性 能 。 





第 10 章 是 本 书 的 最 后 一 章 ， 它 将 展示 Go Web 应 用 的 部 署 方法 。 读 
者 将 会 学 到 如 何 把 应 用 部 获 到 独立 的 服务 占 上 ， 如 何 把 应 用 部 团 到 
Heroku、Google App Engine 之 类 的 云 平台 上 ， 以 及 如 何 把 应 用 部 署 到 
Docker 容 器 里 面 。 











最 后 ， 本 书 的 附录 会 展示 在 不 同 平 台 上 安装 和 设置 Go 环境 的 方 
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ANAS A rE VA BB aK 


ASP US E ARELA RIIT AER SACS. AS oR 
一 般 的 正文 区 别 开 来 ， 书 中 的 源 代 码 都 会 使 用 等 宽 字 体 。 为 了 吓 显 东 些 
代码 在 不 同 章节 之 间 的 区 别 ， 又 或 者 为 了 强调 正文 中 讨论 的 茶 些 代码 ， 
本 书 有 时 候 也 会 以 加 粗 的 方式 显示 代码 。 





除 此 之 外 ， 本 书 的 电子 书 还 会 使 用 彩色 字体 来 凸显 代码 命令 以 及 代 
码 输出 : 


curl -i 127.0.0.1:8080/write 

HTTP/1.1 200 OK 

Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 

Content-Type: text/html; charset=utf-8 


<html> 

<head><title>Go Web Programming</title></head> 
<body><h1>Hello World</h1></body> 

</html> 





本 书展 示 的 所 有 代码 都 可 以 在 www.manning.com/books/go-web- 
programming 和 github.com/ sausheong/gwp 找 到 [31 。 


作者 简介 





郑 兆 雄 〈Sau Sheong Chang) ， 现 任 新 加 坡 能 源 有 限 公 司 数字 技术 
总 裁 ， 在 此 之 前 他 曾经 担任 过 PayPal 的 消费 者 工程 经 理 。Sau 是 Ruby 社 
区 和 Go 社区 一 位 活跃 的 贡献 者 ， 除 了 创作 书籍 之 外 ， 他 还 为 开源 项 目 
提交 代码 ， 并 在 各 种 技术 研讨 会 和 技术 会 议 上 发 言 。 





作者 在 线 论 坛 


购买 本 书 英 文 版 的 读者 可 以 免 绽 地 访问 由 Manning 出 版 社 开设 的 私 
有 Web 论 坛 ， 可 以 在 论坛 里 面 撰写 书评 、 提 出 技术 问题 并 接受 来 自作 者 
和 其 他 读者 的 帮助 。 为 了 访问 并 订阅 论坛 ， 需 要 先 使 用 浏览 器 访问 
www.manning.com/books/go-web-programming， 这 个 页 面 会 告诉 读者 注 
册 账 号 和 访问 论坛 的 方法 ， 除 此 之 外 ， 该 页 面 还 列举 了 论坛 提供 的 各 种 
帮助 以 及 论坛 的 各 项 规章 制度 。 


Manning 出 版 社 承 诡 为 读者 提供 论坛 作为 场所 ， 以 便 读 者 之 间 以 及 
读者 和 作者 之 间 可 以 进行 有 意义 的 对 话 ， 但 Manning 并 不 保证 作者 的 参 
与 程度 一 一 作者 对 论坛 的 任何 页 献 剖 是 自愿 并 且 无 偿 的 ， 因 此 读者 应 该 
尽 可 能 地 提出 一 些 具有 挑战 性 的 问题 以 便 引 起 作者 的 兴趣 。 





只 要 本 书 仍 在 正常 销售 ， 本 书 的 作者 在 线 论 坛 以 及 论坛 上 已 有 的 帖 
子 就 会 一 直 可 供 访 问 。 


[1] Go in Action 的 中 文 版 已 由 人 民 邮 电 出 版 社 出 版 ， 中 文 版 书 名 为 《Go 
语言 实战 》。 一 一 译 者 注 


[2] The Go Programming Language 的 中 文 版 已 由 机 械 工 业 出 版 社 出 版 ， 
中 文 版 书 名 为 《Go 程序 设计 语言 》。 一 一 译 者 注 


[B] 本 书展 示 的 所 有 代码 也 可 以 在 异步 社区 (www.epubit.com.cn) 中 本 
书页 面 免费 下 载 。 一 一 编者 注 


天 于 封面 捕 图 


本 书 的 封面 插图 系 Paolo Mercuri (1804—1884) 所 作 ， 标 题 为 “穿着 
中 世纪 服装 的 男人 ”， 该 插图 来 源 于 Camille Bonnard 搜 集 并 编辑 的 
Costumes Historiques ARRE) 多 卷 本 ， 该 书 于 19 世 纪 50 或 60 年 代 在 巴 
黎 出 版 ， 它 搜集 了 大 量 12 世 纪 、13 世 纪 、14 世 纪 和 15 世 纪 的 历史 服装 。 
随 着 异国 风情 和 历史 文明 在 19 世 纪 风 靡 ， 人 们 开始 着 迷 于 这 类 服 疙 收藏 
本 ， 并 类 此 去 探索 自己 所 在 的 世界 以 及 已 经 远 去 的 旧 世 界 。 





在 这 一 历史 国 册 中 ，Mercuri 丰 富 多 彩 的 画作 让 我 们 生动 地 回想 起 
了 数 百 年 前 ， 世 界 各 地 不 同城 市 和 地 区 之 间 的 文化 差异 。 无 论 是 在 街道 
还 是 乡间 ， 仅 仅 通 过 人 们 的 着 闭 残 可 以 八 九 不 离 十 地 辨识 他 们 的 社会 地 
位 、 从 事 的 行业 和 职业 。 在 经 历 了 数 个 世纪 的 变迁 以 后 ， 人 们 的 着 装 方 
式 已 经 发 生 了 很 大 的 变化 ， 当 初 直 富 多 彩 的 地 区 多 样 性 也 已 逐渐 消失 。 
时 至 今日 ， 仪 仅 通 过 着 装 已 经 很 难 区 分 不 同 大 洲 的 居民 了 ， 更 别 说 想 要 
知道 他 们 所 在 的 国家 和 城市 、 知 舌 他 们 的 社会 地 位 和 职业 了 。 乐 观 地 
讲 ， 也 许 我 们 已 经 放弃 了 妃 求 文化 上 的 多 样 性 ， 转 为 拥抱 更 丰富 多 彩 也 
更 快 节奏 的 技术 生活 了 。 














在 计算 机 书籍 正在 变 得 越 来 越 相 似 、 越 来 越 同 质 化 的 今天 ， 
Manning 出 版 社 希 望 通过 Mercuri 的 作品 ， 将 数 个 世纪 以 前 丰富 多 彩 的 地 
区 生活 融入 图 书 封 面 ， 以 此 来 赞美 计算 机 行业 不 断 创 新 和 敢 为 人 先 的 精 
神 。 








第 一 部 分 Go 与 Web 应 用 


Web 应 用 是 当今 使 用 最 为 广泛 的 一 类 软件 应 用 ， 连 接 人 至 互联 网 的 人 
们 基本 上 每 天 都 在 使 用 Web 应 用 。 因 为 很 多 看 上 去 像 是 原生 应 用 的 移动 
应 用 都 在 内 部 包含 了 使 用 Web 技 术 构 建 的 组 件 ， 所 以 使 用 移动 设备 的 人 
们 实际 上 也 是 在 使 用 Web 应 用 。 











因为 编写 Web 应 用 必须 对 HTTP 有 所 了 解 ， 所 以 接 下 来 的 两 章 将 对 
HTTP 进 行 介绍 。 除 此 之 外 ， 我 们 还 会 了 解 到 使 用 Go 语言 编写 Web 应 用 
的 优点 ， 并 且 实际 使 用 Go 语言 来 构建 一 个 简单 的 网 上 论坛 ， 然 后 鸟 本 
Web 应 用 的 各 个 组 成 部 分 。 


第 1 音 ”Go 与 Web 应 用 


本 章 主要 内 容 


。 Web 应 用 的 定义 

。 使 用 Go 语言 编写 Web 应 用 的 优点 

© Web 应 用 编程 的 基本 知识 

。 使 用 Go 语言 编写 一 个 极为 简单 的 web 应 用 


Web 应 用 在 我 们 的 生活 中 无 处 不 在 。 看 看 我 们 日 党 使 用 的 各 个 应 用 
程序 ， 它 们 要 么 是 Web 应 用 ， 要 么 是 移动 App 这 类 Web 应 用 的 变种 。 无 
论 哪 一 种 编程 语言 ， 只 要 它 能 够 开发 出 与 人 类 交互 的 软件 ， 它 就 必然 会 
文 持 Web 应 用 开发 。 对 一 门 加 新 的 编程 语言 来 说 ， 它 的 开发 者 首先 要 做 
的 一 件 事 ， 就 是 构建 与 互联 网 Gnternet) 和 和 万维网 (World Wide Web) 
交互 的 库 〈library) 和 框架 ， 而 那些 更 为 成 熟 的 编程 语言 还 会 有 各 种 五 
花 八 门 的 web 开 发 工具 。 








Go 是 一 门 刚 开始 轩 露 头角 的 语言 ， 它 是 为 了 让 人 们 能 够 简单 且 高 
效 地 编写 后 端 系统 (back end system) 而 创建 的 。 这 门 语言 拥有 众多 先 
进 的 特性 ， 并 且 密 切 关 注 程 序 员 的 生产 力 以 及 各 种 与 速度 相关 的 事项 。 
和 其 他 语言 一 样 ，Go 语 言 也 提供 了 对 Web 编 程 的 文 持 。 目 从 问世 以 来 ， 
Go 语言 在 编写 Web 应 用 以 及 “x 即 服务 系统 ”(*-as-a-service system) 方面 
就 受到 了 热烈 奶 捧 。 








本 章 接 下 来 将 列举 一 些 使 用 Go 编写 Web 应 用 的 优点 ， 并 介绍 一 些 关 





于 Web 应 用 的 基本 知识 。 


11 使 用 Go 语言 构建 Web 心 用 


“为 什么 要 使 用 Go 语言 编写 Web 应 用 呢 ? ?作为 本 书 的 读者 ， 我 想 你 
肯定 很 想 知 道 这 个 问题 的 答案 。 本 书 是 一 本 教 人 们 如 何 使 用 Go 语言 进 
行 Web 编 程 的 图 书 ， 而 作为 本 书 的 作者 ， 我 的 任务 就 是 同 你 解释 为 什么 
人 们 会 使 用 Go 语言 进行 Web 编 程 。 本 书 将 在 接 下 来 的 内 容 中 陆续 介绍 
Go 语言 在 Web 开 发 方面 的 优点 ， 我 衷心 地 希望 你 也 能 够 对 这 些 优点 有 感 
同 里 受 的 想法 。 


Go 是 一 门 相 对 比较 年 轻 的 编程 语言 ， 它 拥有 索 襟 并 且 仍 在 不 断 成 
长 的 社区 ， 并 且 它 也 非常 适合 用 来 编写 那些 需要 快速 运行 的 服务 器 端 程 
序 。 因 为 Go 语言 提供 了 很 多 过 程式 编程 语言 的 特性 ， 所 以 拥有 过 程式 
编程 语言 使 用 经 验 的 程序 员 对 Go 应 该 都 不 会 感到 陌生 ， 但 与 此 同时 ， 
Go 语言 也 提供 了 函数 式 编 程 方面 的 特性 。 除 了 内 置 对 并 发 编程 的 文 持 
之 外 ，Go 语 言 还 拥有 现代 化 的 包 管理 系统 、 垃 圾 收集 特性 以 及 一 系列 
包罗 万 象 、 威 力 强大 的 标准 库 。 








里 然 Go 目 带 的 标准 库 已 经 非常 丰富 和 宏大 了 ， 但 Go 仍然 拥有 许多 
质量 上 乘 的 开源 库 ， 它 们 可 以 对 标准 库 不 足 的 地 方 进 行 补充 。 本 书 在 大 
部 分 情况 下 都 会 尽 可 能 地 使 用 标准 库 ， 但 是 偶尔 也 会 使 用 一 些 第 三 方 开 
源 库 ， 以 此 来 展示 开源 社区 提供 的 一 些 另 尽 蹊 径 并 且 富有 创意 的 方法 。 








使 用 Go 语言 进行 Web 开 发 正 变 得 日 益 流 行 ， 很 多 公司 都 已 经 开始 使 
用 Go 了 ， 其 中 包括 Dropbox、SendGrid 这 样 的 基础 设施 公司 ，Square 和 
Hailo 这 样 的 技术 驱动 的 公司 ， 甚 至 是 BBC、 纽 约 时 报 这 样 的 传统 公 


在 开发 大 规模 Web 应 用 方面 ，Go 语 言 提供 了 一 种 不 同 于 现 有 语言 和 
平台 但 又 切实 可 行 的 方案 。 大 规模 可 扩展 的 Web 应 用 通常 需要 具备 以 下 
特质 : 


s 可 扩展 ; 
。 模块 化 ; 
。 可 维护 ; 


。 高 性 能 。 
接 下 来 的 几 小 节 将 分 别 对 这 些 特质 进行 讨论 。 
1.1.1 Go 与 可 扩展 Web 应 用 


大 规模 的 Web 应 用 应 该 是 可 扩展 的 (scalable〉， 这 意味 着 应 用 的 
管理 者 应 该 能 够 人 简单、 快速 地 提升 应 用 的 性 能 以 便 处 理 更 多 请 求 。 如 果 
一 个 应 用 是 可 扩展 的 ， 那 么 它 就 是 线性 的 ， 这 意味 着 应 用 的 管理 者 可 以 
通过 添加 更 多 硬件 来 获得 更 强 的 请 求 处 理 能 








有 两 种 方式 可 以 对 性 能 进行 扩展 : 


e 一 种 是 垂直 扩展 (vertical scaling) ， 即 提升 单 台 设 备 的 CPU 数量 
或 者 性 能 ; 

男 一 种 则 是 水 平 扩 展 (horizontal scaling) ， 即 通过 增加 计算 机 的 
数量 来 提升 性 能 。 








因为 Go 语言 拥有 非常 优异 的 并 及 编程 文 持 ， 所 以 它 在 垂直 扩展 方 


面 拥 有 不 俗 的 表现 : 一 个 Go Web 应 用 只 需要 使 用 一 个 操作 系统 线程 
(OS thread) ， 束 可 以 通过 调度 来 高 效 地 运行 数 十 万 个 goroutine。 


跟 其 他 Web 应 用 一 样 ，Go 也 可 以 通过 在 多 个 Go Web 应 用 之 上 架设 
代理 来 进行 高 效 的 水 平 扩展 。 因 为 Go Web 应 用 都 会 被 编译 为 不 包含 任 
何 动态 依赖 关系 的 静态 二 进 制 文件 ， 所 以 我 们 可 以 把 这 些 文件 分 发 到 没 
有 安装 Go 语言 的 系统 里 ， 从 而 以 一 种 简单 且 一 致 的 方式 部 署 Go Web 
用 。 


1.1.2 ”Go 与 模块 化 Web 应 用 


大 规模 Web 应 用 应 该 由 可 蔡 换 的 组 件 构成 ， 这 种 做 法 能 够 使 开发 者 
更 容易 添加 、 移 除 或 者 修改 特性 ， 从 而 更 好 地 满足 程序 不 断 变 化 的 需 
求 。 除 此 之 外 ， 这 种 做 法 的 另 一 个 好 处 是 使 开发 者 可 以 通过 复 用 模块 化 
的 组 件 来 降低 软件 开发 所 需 的 费用 。 











尽管 Go 是 一 门 静 态 类 型 语言 ， 但 用 户 可 以 通过 它 的 接口 机 制 对 行 

为 进行 描述 ， 以 此 来 实现 动态 类 型 匹配 〈dynamic typing) 。Go 语 言 的 
函数 可 以 接受 接口 作为 参数 ， 这 童 味 着 用 户 只 要 实现 了 接口 所 需 的 方 

法 ， 束 可 以 在 继续 使 用 现 有 代码 的 同时 问 系 统 中 引入 新 的 代码 。 与 此 同 
时 ， 因 为 Go 语言 的 所 有 类 型 都 实现 了 空 接口 ， 所 以 用 户 只 需要 创建 出 

一 个 接受 空 接口 作为 参数 的 函数 ， 束 可 以 把 任何 类 型 的 值 用 作 该 函数 的 
实际 参数 。 此 外 ，Go 语 言 还 实现 了 一 些 在 函数 式 编程 中 非常 常见 的 特 
性 ， 其 中 包括 函数 类 型 、 使 用 函数 作为 值 以 及 闭 包 ， 这 些 特性 允许 用 户 
使 用 已 有 的 函数 来 构建 新 的 函数 ， 从 而 帮助 用 户 构 建 出 更 为 模块 化 的 代 
人 码 。 

















Go 语言 也 经 常会 被 用 于 创建 微服 务 〈microservice) 。 在 微服 务 染 
构 中 ， 大 型 应 用 通常 由 多 个 规模 较 小 的 独立 服务 组 合 而 成 ， 这 些 独 立 服 
务 通常 可 以 相互 蔡 换 ， 并 根据 它们 各 自 的 功能 进行 组 织 。 比 如 ， 日 志 记 
录 服 务 会 被 归 类 为 系统 级 服务 ， 而 开具 账单 、 风 险 分 析 这 样 的 服务 则 会 
被 归 类 为 应 用 级 服务 。 创 建 多 个 规模 较 小 的 Go 服务 并 将 它们 组 合 为 单 
个 Web 应 用 ， 这 种 做 法 使 得 我 们 可 以 在 有 需要 的 时 候 对 应 用 中 的 服务 进 
行 蔡 换 ， 而 整个 web 应 用 也 会 因此 变 得 更 加 模块 化 。 


1.1.3 ”G0 与 可 维护 的 Web 应 用 


和 其 他 庞大 而 复杂 的 应 用 一 样 ， 拥 有 一 个 易于 维护 的 代码 库 
(codebase) 对 大 规模 的 Web 应 用 来 说 也 是 非常 重要 的 。 这 是 因为 大 规 
模 的 应 用 通 芝 都 会 不 断 地 成 长 和 演化 ， 所 以 开发 者 需要 经 党 性 地 回顾 并 
修改 代码 ， 而 修改 难 懂 、 笨 拙 的 代码 需要 人 花费 大 量 的 时 间 ， 并 且 隐 含 
可 能 会 造成 菜 些 功能 无 法 正常 运作 的 风险 。 因 此 ， 确 保 源 代码 能 够 以 适 
当 的 方式 组 织 起 来 并 且 具 有 展 好 的 可 维护 性 对 开发 者 来 说 就 显得 全 天 重 


要 了 。 

















Go 语言 的 设计 辟 励 恨 好 的 软件 工程 实践 ， 它 拥有 简洁 且 极 具 可 读 
性 的 语法 以 及 灵活 且 清 晰 的 包 管 理 系统 。 除 此 之 外 ，Go 语 言 还 有 一 整 
套 优 秀 的 工具 ， 它 们 不 仅 可 以 增强 程序 员 的 开发 体验 ， 还 能 够 帮助 他 们 
写 出 更 具 可 读 性 的 代码 ， 比 如 以 标准 化 方式 对 Go 代码 进行 格式 化 的 源 
代码 格式 化 程序 gofmt 就 是 其 中 一 个 例子 。 


因为 Go 语言 希望 文档 可 以 和 代码 一 同 演进 ， 所 以 它 的 文档 工具 
godoc 会 对 Go 源 代 人 码 及 其 注释 进行 语法 分 析 ， 然 后 以 HTML、 纯 文本 或 
者 其 他 多 种 格式 创建 出 相应 的 文档 。godoc 的 使 用 方法 非常 简单 ， 开 发 





者 只 需要 把 文档 写 到 源 代码 里 面 ，godoc 就 会 把 这 些 文档 以 及 与 之 相关 
联 的 代码 提取 出 来 ， 生 成 相应 的 文档 文件 。 





除 此 之 外 ，Go 还 内 置 了 对 测试 的 支持 : gotest 工 具 会 自动 寻找 与 源 
代码 处 于 同一 个 包 〈package) 之 内 的 测试 代码 ， 并 运行 其 中 的 功能 测 
试 和 性 能 测试 。Go 语 言 也 提供 了 Web 应 用 测试 工具 ， 这 些 工 具 可 以 模拟 
出 一 个 Web 服 务 器 ， 并 对 该 服务 器 生 成 的 啊 应 (response) 进行 记录 。 


1.1.4 ”G0 与 高 性 能 Web 应 用 





高 性 能 不 仅 意 味 着 能 够 在 短 时 间 内 处 理 大 量 请 求 ， 还 意味 着 服务 器 
能 够 快速 地 对 客户 端 进 行 啊 应 ， 并 让 终端 用 户 (end user) 能 够 快速 地 
执行 操作 。 


Go 语言 的 一 个 设计 目标 就 是 提供 接近 于 C 语 言 的 性 能 ， 尽 管 这 个 目 
标 目 前 尚未 达成 ， 但 Go 语言 现在 的 性 能 已 经 非常 具有 竞争 力 : Go 程序 
会 被 编译 为 本 地 人 码 (native code) ， 这 一 般 意 味 着 Go 程序 可 以 运行 得 比 
解释 型 语言 的 程序 要 快 ， 并 且 就 像 前 面 说 过 的 那样 ，Go 语 言 的 goroutine 
对 并 及 编程 提供 了 非常 好 的 支持 ， 这 使 得 Go 应 用 可 以 同时 处 理 多 个 请 

















希望 以 上 介绍 能 够 引起 你 对 使 用 Go 语言 及 其 平台 进行 Web 开 发 的 兴 
趣 。 但 是 在 学 习 如 何 使 用 Go 进行 Web 开 发 之 前 ， 我 们 需要 先 来 了 解 一 下 
什么 是 Web 应 用 ， 以 及 它们 的 工作 原理 是 什么 ， 这 会 给 我 们 学 习 之 后 几 
革 的 内 容 带 来 非常 大 的 帮助 。 


1.2 Web 应 用 的 工作 原理 


如 果 你 在 一 个 技术 会 议 上 疝 在 场 的 程序 员 们 提出 “什么 是 Web 应 
用 ”这 一 问题 ， 那 么 通常 会 得 到 五 花 八 门 的 回答 ， 有 些 人 甚至 可 能 还 会 
因为 你 问 了 个 如 此 基础 的 问题 而 感到 惊讶 和 不 解 。 通 过 不 同 的 人 对 这 个 
问题 的 不 同 回答 ， 我 们 可 以 了 解 到 人 们 对 Web 应 用 并 没有 一 个 十 分 明确 
的 定义 。 比 如 说 ，Web 服 务 算 不 算 Web 应 用 ? 因为 Web 服 务 通常 会 被 其 
他 软件 调用 ， 而 Web 应 用 则 是 为 人 类 提供 服务 ， 所 以 很 多 人 都 认为 Web 
服务 与 Web 应 用 是 两 种 不 同 的 事物 。 但 如 果 一 个 程序 能 够 像 RSS feed 那 
样 ， 产 生出 来 的 数据 既 可 以 被 其 他 软件 使 用 ， 又 可 以 被 人 类 理解 ， 那 么 
这 个 程序 到 底 是 一 个 Web 服务 还 是 一 个 web 应 用 呢 ? 











同样 地 ， 如 果 一 个 应 用 只 会 返回 HTML 页面， 但 却 并 不 对 页 面 进行 
任何 处 理 ， 那 么 它 是 一 个 Web 应 用 吗 ? 运行 在 Web 浏览 器 之 上 的 Adobe 
Flash 程 序 是 一 个 Web 应 用 吗 ? 对 于 一 个 纯 HIML5 编 写 的 应 用 ， 如 果 它 
运行 在 一 个 长 期 驻 留 于 电脑 的 浏览 器 中 ， 那 么 它 算是 一 个 Web 应 用 吗 ? 
如 果 一 个 应 用 在 向 服务 器 发 送 请 求 时 没有 使 用 HTTP 协 议 ， 那 么 它 算 是 
一 个 Web 应 用 吗 ? 大 多 数 程序 员 都 能 够 从 高 层次 的 角度 去 理解 Web 应 用 
是 什么 ， 但 是 一 旦 我 们 深入 一 些 ， 堂 试 去 探究 Web 应 用 的 实现 层次 ， 事 
情 就 会 变 得 含糊 不 清 起 来 。 

















从 纯粹 且 狭 隘 的 角度 来 看 ，Web 应 用 应 该 是 这 样 的 计算 机 程序 : 它 
会 对 客户 端 发 送 的 HITP 请 求 做 出 响应 ， 并 通过 HTTP 响应 将 HIML 回 传 
至 客户 端 。 但 这 样 一 来 ，Web 应 用 不 就 跟 Web 服 务 器 一 样 了 吗 ? 的 确 如 
此 ， 如 果 按 照 上 面 给 出 的 定义 来 看 ，Web 服 务 器 和 Web 应 用 将 没有 区 别 


: 一 个 Web 服 务 喜 就 是 一 个 Web 应 用 〈 如 图 1-1 所 示 ) 。 








图 1-1 Web 应 用 最 基本 的 请 求 与 啊 应 结构 





将 Web 服 务 器 看 作 是 Web 应 用 的 一 个 问题 在 于 ， 像 httpd 和 Apache 这 
样 的 Web 服 务 器 都 会 监视 特定 的 目录 ， 并 在 接收 到 请 求 时 返回 位 于 该 目 
录 中 的 文件 (比如 Apache 就 会 对 docroot 目 录 进 行 监视 ) 。 与 此 相反 ， 
Web 应 用 并 不 会 简单 地 返回 文件 : 它 会 对 请 求 进行 处 理 ， 并 执行 应 用 程 
序 中 预先 设 定好 的 操作 (如 图 1-2 所 示 〉。 


Web 应 用 接收 请 求 ， 执 行 
程序 指定 的 操作 ， 然 后 返回 文件 。 


请 求 
客户 端 服务 器 MF 
响应 


图 1-2 Web 应 用 的 工作 原理 























从 以 上 观点 来 看 ， 我 们 也 许可 以 把 Web 服 务 器 看 作 是 一 种 特殊 的 
Web 应 用 ， 这 种 应 用 只 会 返回 被 请 求 的 文件 。 普 裔 来 讲 ， 很 多 用 户 都 会 
把 使 用 浏览 器 作为 客户 端的 应 用 看 作 是 Web 应 用 。 这 其 中 包括 Adobe 
Flash 必 用 、 单 页 web 应 用 ， 甚 至 是 那些 不 使 用 HTTP 协 议 进 行 通信 但 却 


驻 留 在 果 面 或 系统 上 的 应 用 。 


为 了 在 书 中 讨论 Web 编 程 的 相关 技术 ， 我 们 必须 给 这 些 技 术 一 个 明 
确 的 定义 。 首 先 ， 让 我 们 来 给 出 应 用 的 定义 。 





应 用 Capplication) 是 一 个 与 用 户 进行 互动 并 帮助 用 户 执行 指定 活 
动 的 软件 程序 。 比 如 记 账 系统 、 人 力 资 源 系 统 、 果 面 出 版 软件 等 。 而 
Web 应 用 则 是 部 署 在 web 之 上 ， 并 通过 Web 来 使 用 的 应 用 。 








换 句 话说 ， 一 个 程序 只 需要 满足 以 下 两 个 条 件 ， 我 们 就 可 以 把 它 看 
作 是 一 个 Web 应 用 : 


这 个 程序 必须 癌 发 送 命令 请 求 的 客户 端 返回 HTML， 而 客户 端 则 会 
向 用 户 展示 演 染 后 的 HTML; 
这 个 程序 在 向 客户 端 传送 数据 时 必需 使 用 HITTP 协 议 。 








在 这 个 定义 的 基础 上 ， 如 果 一 个 程序 不 是 同 用 户 渲染 并 展示 
HTML， 而 是 同 其 他 程序 返回 菜 种 非 HTML 格 式 的 数据 ， 那 么 这 个 程序 
就 是 一 个 为 其 他 程序 提供 服务 的 Web 服 务 。 本 书 将 在 第 7 章 对 Web 服 务 
进行 更 详细 的 说 明 。 


与 大 部 分 程序 员 对 Web 应 用 的 定义 相 比 ， 上 面 给 出 的 定义 可 能 显得 
稍微 狭隘 了 一 些 ， 但 因为 这 个 定义 消除 了 所 有 的 模糊 与 不 清晰 ， 并 使 
Web 应 用 变 得 更 加 易于 理解 ， 所 以 它 对 于 本 书 讨论 的 问题 是 非常 有 帮助 
的 。 随 着 读者 对 本 书 阅 读 的 不 断 深入 ， 这 一 定义 将 变 得 更 为 清晰 ， 但 是 
在 此 之 前 ， 让 我 们 先 来 回顾 一 ~hHTTIP 协 议 的 发 展 历程 。 


1.3 HTTP 人 简介 


HTTP 是 万 维 网 的 应 用 层 通 信 协 议 ，Web 页 面 中 的 所 有 数据 都 是 通 
过 这 个 看 似 简 单 的 文本 协议 进行 传输 的 。HTTP 非 常 朴素 ， 但 却 异 常 地 
强大 一 一 这 个 协议 自 20 世 纪 90 年 代 定 义 以 来 ， 至 今 只 进行 了 3 次 迭代 修 
改 ， 其 中 HTTP 1.1 是 目前 使 用 最 为 广泛 的 一 个 版 本 ， 而 最 新 的 一 个 版 本 
则 是 HTTP 2.0， 又 称 HTTP/2。 





HTTP 的 最 初版 本 HTTP 0.9 是 由 Tim Berners-Lee 为 了 让 万 维 网 能 够 
得 以 被 采纳 而 创建 的 : 它 允 许 客户 端 与 服务 器 进行 连接 ， 并 辐 服 务 器 发 
送 以 空 行 CCRLF) 结尾 的 ASCII 字 符 串 请 求 ， 而 服务 器 则 会 返回 不 融 任 
何 元 数据 的 HTML 作 为 响应 。 








HTTP 0.9 之 后 的 每 个 新 版 本 实现 都 包含 了 大 量 的 新 特性 ，1996 年 发 
布 的 HITP 1.0 就 是 由 大 量 特性 合并 而 成 的 ， 之 后 的 HITP 1.1 版 本 于 1999 
年 发 布 ， 而 HTTP 2.0 版 本 则 于 2015 年 发 布 。 因 为 目前 使 用 最 为 广泛 的 还 
是 HTTP 1.1 版 本 ， 所 以 本 书 主要 还 是 对 HTTP 1.1 进 行 讨论 ， 但 也 会 在 适 
当 的 地 方 介绍 一 些 HTTP 2.0 的 相关 信息 


首先 ， 让 我 们 通过 一 个 简单 的 定义 来 说 明 什 么 是 HITP。 





HTTP 是 一 种 无 状态 、 由 文本 构成 的 请 求 -响应 〈request-response) 协 
议 ， 这 种 协议 使 用 的 是 客户 端 -服务 器 (client-server) 计算 模型 。 











请 求 - 啊 应 是 两 台 计 算 机 进行 通信 的 基本 方式 ， 其 中 一 台 计 算 机 会 


同 男 一 台 计 算 机 发 送 请 求 ， 而 接收 到 请 求 的 计算 机 则 会 对 请 求 进行 响 
应 。 在 客户 端 - 服 务 器 计算 模型 中 ， 发 送 请 求 的 一 方 (客户 端 ) 负责 问 
返回 响应 的 一 方 (服务 器 ) 发 起 会 话 ， 而 服务 器 则 负责 为 客户 端 提 供 
服务 。 在 HITP 协 议 中 ， 客 户 端 也 被 称 作 用 户 代理 Cuser-agent) ， 而 服 
务 器 则 通常 会 被 称 为 Web 服 务 器 。 在 大 多 数 情况 下 ，HTTP 客 户 端 都 是 
一 个 web 浏览 器 。 














HTTP 是 一 种 无 状态 协议 ， 它 唯一 知道 的 就 是 客户 端 会 向 服务 器 发 
送 请 求 ， 而 服务 器 则 会 同 客 户 端 返回 响应 ， 并 且 后 续 发 生 的 请 求 对 之 前 
发 生 过 的 请 求 一 无 所 知 。 相 对 的 ， 像 FTP、Telnet 这 类 面向 连接 的 协议 
则 会 在 客户 端 和 服务 器 之 间 创 建 一 个 持续 存在 的 通信 通道 (其 中 Telnet 
在 进行 通信 时 使 用 的 也 是 请 求 -响应 方式 以 及 客户 端 -服务 器 计算 模 
型 ) 。 顺 带 提 一 下 ，HTITP 1.1 也 可 以 通过 持久 化 连接 来 提升 性 能 。 








跟 很 多 互联 网 协议 一 样 ，HTTP 也 是 以 纯 文本 方式 而 不 是 二 进 制 方 
式 肥 送 和 接收 协议 数据 的 。 这 样 做 是 为 了 让 开发 者 可 以 在 无 需 使 用 专门 
的 协议 分 析 工 具 的 情况 下 ， 弄 清楚 通信 中 正在 发 生 的 事情 ， 从 而 更 容易 
进行 故障 排 得 。 


因为 HTTP 最 初 在 设计 时 只 用 于 传送 HTML， 所 以 HTTP 0.9 只 提供 
了 GET 这 一 个 方法 (method) ， 但 新 版 本 对 HTTP 的 扩展 使 它 逐 渐变 成 
了 一 种 通用 的 协议 ， 用 户 也 得 以 将 其 应 用 于 Web 应 用 等 分 布 式 系统 中 ， 
本 章 接 下 来 就 会 对 Web 应 用 进行 介绍 。 








1.4 Web 应 用 的 诞生 





在 万 维 网 出 现 不 久之 后 ， 人 们 开始 意识 到 一 点 : 尽管 使 用 Web 服 务 
器 处 理 静 态 HTML 文 件 这 个 主意 非常 棱 ， 但 如 果 HIML 里 面 能 够 包含 动 
态 生成 的 内 容 ， 那 么 事情 将 会 变 得 更 加 有 趣 。 其 中 ， 通 用 网 关 接 口 
(Common Gateway Interface, CGI )〉 束 是 在 早期 尝试 动态 生成 HTML 内 
容 的 技术 之 一 。 














1993 年 ， 美 国 国 家 超级 计算 应 用 中 心 (National Center for 
Supercomputing Applications, NCSA) 编写 了 一 个 在 Web 服 务 器 上 调用 
可 执行 命令 行程 序 的 规范 (specification〉， 他 们 把 这 个 规范 命名 为 
CGI， 并 将 它 包含 在 了 NCSA 开 友 的 广 受 欢迎 的 HTTPd 服 务 嚣 里面。 不 
过 NCSA 制 定 的 这 个 规范 最 终 并 没有 成 为 正式 的 互联 网 标准 ， 只 有 CGI 
这 个 名 字 被 后 来 的 规范 沿用 了 下 来 。 


CGI 是 一 个 简单 的 接口 ， 它 允许 web 服务 器 与 一 个 独立 运行 于 Web 
服务 器 进程 之 外 的 进程 进行 对 接 。 通 过 CGI 与 服务 占 进 行 对接 的 程序 通 
第 被 称 为 CGI 程序 ， 这 种 程序 可 以 使 用 任何 编程 语言 编号 一 一 这 也 是 我 
们 把 这 种 接口 称 之 为 “通用 ”接口 的 原因 ， 不 过 早期 的 CGI 程序 大 多 数 都 
是 使 用 Perl 语 言 编写 的 。 癌 CGI 程序 传递 输入 参数 是 通过 设置 环境 变量 
来 完成 的 ，CGI 程 序 在 运行 之 后 将 向 标准 输出 〈stand output) 返回 结 
果 ， 而 服务 器 则 会 将 这 些 结果 传 送 至 客户 端 。 





与 CGI 同期 出 现 的 还 有 服务 器 端 包含 (server-side includes, SSI ) 
技术 ， 这 种 技术 允许 开发 者 在 HTML 文 件 里 面包 含 一 些 指令 








(directive) : 当 客 户 端 请 求 一 个 HTML 文 件 的 时 候 ， 服 务 器 在 返回 这 
个 文件 之 前 ， 会 先 执 行文 件 中 包含 的 指令 ， 并 将 文件 中 出 现 指令 的 位 置 
蔡 换 成 这 些 指令 的 执行 结 末 。SSI 最 常见 的 用 法 是 在 HIML 文 件 中 包含 
其 他 被 频 汝 使 用 的 文件 ， 又 或 者 将 整个 网 站 都 会 出 现 的 页 面 首 部 
(header) 以 及 尾部 Cooter) HJAR RERA HTML LAFF o 








作为 例子 ， 以 下 代码 演示 了 如 何 通 过 SSI 指 令 将 navbar.shtml X 
件 中 的 内 容 包 含 到 HTML 文 件 中 : 


<html> 
<head><title>Example SSI</title></head> 
<body> 
<!--#include file="navbar.shtml" --> 


</body> 
</html> 











SSI 技 术 的 最 终 演 化 结果 就 是 在 HTML 里 面包 含 更 为 复杂 的 代码 ， 
并 使 用 更 为 强大 的 解释 器 Cinterpreter) 。 这 一 模式 衍生 出 了 PHP、 
ASP、JSP 和 ColdFusion 等 一 系列 非常 成 功 的 引擎 ， 开 发 者 通过 使 用 这 些 
引擎 能 够 开发 出 各 式 各 样 复杂 的 Web 应 用 。 除 此 之 外 ， 这 一 模式 也 是 
Mustache、ERB、Velocity 等 一 系列 Web 模 板 引 擎 的 基础 。 





如 前 所 述 ，Web 应 用 是 为 了 通过 HTTP 向 用 户 发 送 定 制 的 动态 内 容 
而 诞生 的 ， 为 了 弄 明 白 Web 应 用 的 运作 原理 ， 我 们 必须 知道 HTTP 的 工 
作 过 程 ， 并 理解 HTTP 请 求 和 啊 应 的 运作 机 制 。 





15 HTTP 请求 








HTTP 是 一 种 请 求 - 啊 应 协议 ， 协 议 涉 及 的 所 有 事情 都 以 一 个 请 求 开 
始 。 OO (message) 一 样 ， 都 由 一 系列 文 
本 行 组 成 ， 这 些 文本 行 会 按照 以 下 顺序 进行 排列 : 





(1) 请 求 行 (request-line) ; 





(2) 零 个 或 任意 多 个 请 求 首 部 Cheader) ; 
C3) = 个 空 行 ; 
(4) 可 选 的 报 文 主体 (body) . 


一 个 典型 的 HTTP 请 求 看 上 去 是 这 个 样子 的 : 





GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 
User-Agent: Mozilla/5.0 


(empty line) 





这 个 请 求 中 的 第 一 个 文本 行 就 是 请 求 行 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 


请 求 行 中 的 第 一 个 单词 为 请 求 方法 (request method) ， 之 后 跟着 
的 是 统一 资源 标识 符 (Uniform Resource Identifier, URI ) 以 及 所 用 的 


HTTPHRA. PIT ZIRE AT A RA So TERE, IRS 
报 文 的 最 后 一 行为 空 行 ， 即 使 报 文 的 主体 部 分 为 空 ， 这 个 空 行 也 必须 存 
在 ， 至 于 报 文 是 否 包 含 主体 则 需要 根据 请 求 使 用 的 方法 而 定 。 


1.5.1 请求 方法 





请 求 方法 是 请 求 行 中 的 第 一 个 单词 ， 它 指明 了 客户 端 想 要 对 资源 执 
ITHE. HTTP 0.9 只 有 GET 一 个 方法 ，HTTP 1.0 添 加 了 POST 方法 和 
HEAD 方法 ， 而 HTTP 1.1 则 添加 了 PUT 、DELETE 、OPTIONS 、TRACE 和 
CONNECT 这 5 个 方法 ， 并 人 允许 开发 者 自行 添加 更 多 方法 一 一 很 多 人 立即 
就 把 这 个 功能 付 诸 实践 了 。 


关于 请 求 方法 的 一 个 有 趣 之 处 在 于 ，HTTP 1.1 要 求 必须 实现 的 只 
有 GET 方法 和 HEAD 方法 ， 而 其 他 方法 的 实现 则 是 可 选 的 ， 甚 至 连 POST 
方法 也 是 可 选 的 。 


各 个 HTTP 方 法 的 作用 说 明 如 下 。 


GET 命令 服务 器 返回 指定 的 资源 。 

HEAD 一 一 与 GET 方法 的 作用 类 似 ， 唯 一 的 不 同 在 于 这 个 方法 不 要 天 
服务 器 返回 报 文 的 主体 。 这 个 方法 通常 用 于 在 不 获取 报 文 主体 的 情 
况 下 ， 取 得 响应 的 首部 。 

POST 命令 服务 器 将 报 文 主体 中 的 数据 传递 给 URI 指 定 的 资源 ， 
至 于 服务 器 具体 会 对 这 些 数据 执行 什么 动作 则 取决 于 服务 器 本 里 。 

PUT 命令 服务 器 将 报 文 主体 中 的 数据 设置 为 URI 指 定 的 资源 。 

如 果 URI 指 定 的 位 置 上 已 经 有 数据 存在 ， 那 么 使 用 报 文 主体 中 的 数 
据 去 代 蔡 已 有 的 数据 。 如 果 资 源 尚未 存在 ， 那 么 在 URI 指 定 的 位 置 























上 新 创建 一 个 资源 。 








e DELETE 命令 服务 器 删除 URI 指 定 的 资源 。 
e TRACE 命令 服务 器 返回 请 求 本 身 。 通 过 这 个 方法 ， 客 户 端 可 以 


知道 介 于 它 和 服务 器 之 间 的 其 他 服务 器 是 如 何 处 理 请 求 的 。 
OPTIONS 命令 服务 器 返回 ee 

CONNECT 命令 服务 器 与 客户 端 建立 一 个 网 络 连接 。 方法 通 
常用 于 设置 SSL 隧 道 以 开启 HTTPS 功 能 











e PATCH 命令 服务 器 使 用 aca thik SAMI 下 定 的 资源 进 
行 修改 。 


15.2 ”安全 的 请 求 方法 


如 果 一 个 HITP 方 法 只 要 求 服 务 器 提供 信息 而 不 会 对 服务 器 的 状态 
做 任何 修改 ， 那 么 这 个 方法 就 是 安全 的 (safe) 。GET 、HEAD 
~ OPTIONS 和 TRACE 都 不 会 对 服务 器 的 状态 进行 修改 ， 所 以 它们 都 是 安 
全 的 方法 。 与 此 相反 ，POST 、PUT 和 DELETE 都 能 够 对 服务 器 的 状态 进 
行 修 改 〈 比 如 说 ， 在 处 理 POST 请 求 时 ， 服 务 器 存储 的 数据 就 可 能 会 发 
生变 化 ) ， 国 此 这 些 方法 都 不 是 安全 的 方法 。 








15.3 ”党 等 的 请 求 方法 


如 末 一 个 HITP 方 法 在 使 用 相同 的 数据 进行 第 二 次 调用 的 时 候 ， 不 
会 对 服务 器 的 状态 造成 任何 改变 ， 那 么 这 个 方法 就 是 赂 等 的 
(idempotent) 。 根 据 安全 的 方法 的 定义 ， 因 为 所 有 安全 的 方法 都 不 会 
修改 服务 器 状态 ， 所 以 它们 天 生 就 是 暴 等 的 。 








PUT 和 DELETE 虽然 不 安全 ， 但 却 是 窜 等 的 ， 这 是 因为 它们 在 进行 


第 二 次 调用 时 都 不 会 改变 服务 器 的 状态 : 因为 服务 器 在 执行 第 一 个 PUT 
请 求 之 后 ，URI 指 定 的 资源 已 经 被 更 新 或 者 创建 出 来 了 ， 上 所 以 针对 同一 
个 资源 的 第 二 次 PUT 请 求 只 会 执行 服务 器 已 经 执行 过 的 动作 ， 与 此 类 
似 ， 虽 然 服务 器 对 于 同一 个 资源 的 第 二 次 DELETE 请 求 可 能 会 返回 一 个 
错误 ， 但 这 个 请 求 并 不 会 改变 服务 器 的 状态 。 





相反 ， 因 为 重复 的 POST 请 求 是 否 会 改变 服务 器 状态 是 由 服务 品目 
号 决定 的 ， 所 以 POST 方法 既 不 安全 也 非 虞 等。 豁 等 性 是 一 个 非常 重要 
的 概念 ， 本 书 第 7 章 在 介绍 Web 服 务 时 将 再 次 提 及 这 个 概念 。 


1.5.4 浏览 器 对 请 求 方法 的 支持 


GET 方法 是 最 基本 的 HTTP 方法 ， 它 负责 从 服务 器 上 获取 内 容 ， 所 
有 浏览 器 都 支持 这 个 方法 。POST 方法 从 HTML 2.0 开始 可 以 通过 添加 
HTML 表 单 来 实现 : HTML 的 form 标签 有 一 个 名 为 method 的 属性 ， 用 
户 可 以 通过 将 这 个 属性 的 值 设 置 为 get 或 者 post 来 指定 要 使 用 哪 种 方 
法 。 

HTML 不 支持 除 GET 和 POST 之 外 的 其 他 HTTP 方 法 : 在 HIML5 规 范 


的 早期 草案 中 ，HTML 表 单 的 method 属性 曾经 添加 过 对 PUT 方法 和 
DELETE 方法 的 文 持 ， 但 这 些 文 持 在 之 后 又 被 删除 了 。 





话 虽 如 此 ， 但 流行 的 浏览 器 通常 都 不 会 只 文 持 HTML 一 种 数据 格式 
一 一 用 户 可 以 使 用 XMLHttpRequest (XHR) 来 获得 对 PUT 方法 和 DELTE 
方法 的 支持 。XHR 是 一 系列 浏览 器 API， 这 些 API 通 常 由 JavaScript 包 更 

(实际 上 XHR 就 是 一 个 名 为 XMLHttpRequest 的 浏览 器 对 象 )。XHR 人 允 
许 程 序 员 向 服务 器 发 送 HTTP 请 求 ， 并 且 跟 “XMLHttpRequest” 这 个 名 字 











所 暗示 的 不 一 样 ， 这 项 技术 并 不 仅仅 局 限于 XML 格式 一 一 包括 JSON 以 
及 纯 文 本 在 内 的 任何 格式 的 请 求 和 啊 应 都 可 以 通过 XHR 有 送 。 


1.5.5 “请求 首 部 
HTTP 请 求 方法 定义 了 发 送 请 求 的 客户 端 想 要 执行 的 动作 ， 而 HITP 
请 求 的 首部 则 记录 了 与 请 求 本 身 以 及 客户 端 有 关 的 信息 。 请 求 的 首部 由 


任意 多 个 用 冒号 分 隔 的 纯 文 本 键 值 对 组 成 ， 最 后 以 回 车 CCR) 和 换行 
(LE) aes 














作为 HTTP 1.1 RFC 的 一 部 分 ，RFC 7231 对 主要 的 一 些 HTTP 请 求 字 
Px (request field) 进行 了 标准 化 。 过 去 ， 非 标准 的 HTTP 请 求 通常 以 X- 
作为 前 级 ， 但 标准 并 没有 沿用 这 一 惯例 。 


大 多 数 HTTP 请 求 首 部 都 是 可 选 的 ， 窒 主 (Host〉 首 部 字段 是 HTTP 
1.1 唯 一 强制 要 求 的 首部 。 根 据 请 求 使 用 的 方法 不 同 ， 如 有 果 请 求 的 报 文 
中 包含 有 可 选 的 主体 ， 那 么 请 求 的 首部 还 需要 市 有 内 容 长 度 (Content- 
Length) 字段 或 者 传输 编码 〈Transfer-Encoding) 字段 。 表 1-1 展 示 了 一 
些 常 见 的 请 求 首 部 。 





表 1-1 常见 的 HTTP 请 求 首部 


























客户 端 在 HTTP 响 应 中 能 够 接收 的 内 容 类 型 。 比 如 说 ， 客 户 端 可 以 通 














过 Accept: text/html 这 个 首部 ， 告 知 服务 器 自己 希望 在 啊 应 的 主体 中 
收 到 HTML 类 型 的 内 容 























Accept- 客户 端 要 求 服 务 器 使 用 的 字符 集 编 码 。 比 如 说 ， 客 户 端 可 以 通过 
Charset Accept-Charset: utf-8 这 个 首部 ， 告 知 服务 器 自己 希望 啊 应 的 主体 使 
用 UTF-8 字 符 集 





























Authorization | 这 个 首部 用 于 问 服 务 器 发 送 基本 的 身份 验证 i 











客户 端 应 该 在 这 个 首部 中 把 服务 器 之 前 设置 的 所 有 cookie 回 传 给 服务 
器 。 比 如 说 ， 如 果 服 务 器 之 前 在 浏览 器 上 设置 了 3 个 cookie， 那 么 
Cookie 首 部 字段 将 在 一 个 字符 串 里 面包 含 这 3 个 cookie， 并 使 用 分 号 对 
这 些 cookie 进 行 分 隔 。 以 下 是 一 个 Cookie 首 部 示例 : Cookie: 


my_first_cookie=hello; my_second_cookie=world 





TORE IFRS 

















当 请 求 包含 主体 的 时 候 ， 这 个 首部 用 于 记录 主体 内 容 的 类 型 。 在 发 

送 posT 或 PUT 请 求 时 ， 内 容 的 类 型 默认 为 x-ww-form-urlen-coded , 但 
Content-Type | _, : Ben ee ay . 

是 在 上 传 文件 时 ， 内 容 的 类 型 应 该 设置 为 multipart/form-data (上 传 

文件 这 一 操作 可 以 通过 将 input 标签 的 类 型 设置 为 file 来 实现 ) 


aes 服务 器 的 名 字 以 及 端口 号 。 如 果 这 个 首部 没有 记录 服务 器 的 端口 号 ， 
就 表示 服务 器 使 用 的 是 80 端 口 

发 起 请 求 的 页 面 所 在 的 地 址 

对 发 起 请 求 的 客户 端 进 










































































1.6 HTTP 响 应 


HTTP 咱 应 报 文 是 对 HTTP 请 求 报 文 的 回复 。 跟 HTTP 请 求 一 样 ， 
HTTP 响 应 也 是 由 一 系列 文本 行 组 成 的 ， 其 中 包括 : 


。 一 个 状态 行 ; 
。 雪 个 或 任意 数量 的 啊 应 首部 ; 
。 一 个 空 行 ; 


。 一 个 可 选 的 报 文 主体 。 


也 许 你 已 经 发 现 了 ，HTTP 啊 应 的 组 织 方式 跟 HTTP 请 求 的 组 织 方式 
是 完全 相同 的 。 以 下 是 一 个 典型 的 HTTP 啊 应 的 样子 (为 了 节省 篇 幅 ， 
我 们 省 略 了 报 文 主体 中 的 部 分 内 容 ) : 


266 OK 
Date: Sat, 22 Nov 2014 12:58:58 GMT 
Server: Apache/2 
Last-Modified: Thu, 28 Aug 2014 21:01:33 GMT 
Content-Length: 33115 
Content-Type: text/html; charset=iso-8859-1 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.or 


g/ 
TR/xhtm11/DTD/xhtml1-strict.dtd"> <html xmlns='http://www.w3.org/1999 


/ 


xhtml'> <head><title>Hypertext Transfer Protocol -- HTTP/1.1</title>< 


/ 
head><body>...</body></htm1> 





HTTP 响 应 的 第 一 行为 状态 行 ， 这 个 文本 行 包 含 了 状态 码 (status 
code) 和 相应 的 原因 短语 (reason phrase) ， 原 因 短 语 对 状态 码 进 行 了 


简单 的 描述 。 除 此 之 外 ， 这 个 例子 中 的 HITP 啊 应 还 包 全 了 一 个 HTML 
格式 的 报 文 主体 。 


1.6.1 啊 应 状态 码 


正如 之 前 所 说 ，HTTP 啊 应 中 的 状态 码 表明 了 啊 应 的 类 型 。HTTP 啊 
应 状态 码 共 有 5 种 类 型 ， 它 们 分 别 以 不 同 的 数字 作为 前 级 ， 如 表 1-2 所 
示 。 








表 1-2 _ HTTP 响应 状态 码 


























情报 状态 码 。 服 务 器 通过 这 些 状 态 码 来 告知 客户 端 ， 自 己 已 经 接收 到 了 客户 端 
发 送 的 请 求 ， 并 且 已 经 对 请 求 进行 了 处 理 









































成 功 状 态 码 。 这 些 状态 码 说 明 服 务 器 已 经 接收 到 了 客户 端 发 送 的 请 求 ， 并 且 已 
经 成 功 地 对 请 求 进行 了 处 理 。 这 类 状态 码 的 标准 响应 为 "268 OK” 





























重 定向 状态 码 。 这 些 状态 码 表示 服务 器 已 经 接收 到 了 客户 端 发 送 的 请 求 ， 并 且 
己 经 成 功 处 理 了 请 求 ， 但 为 了 完成 请 求 指定 的 动作 ， 客 户 端 还 需要 再 做 一 些 
































他 工作 。 这 类 状态 码 大 多 用 于 实现 URL 重 定向 








客户 端 错误 状态 码 。 这 类 状态 码 说 明 客 户 端 发 送 的 请 求 出 现 了 某 些 问题 。 在 这 
一 类 型 的 状态 码 中 ， 最 常见 的 就 是 “464 Not Found” 了 ， 这 个 状态 码 表示 服务 器 
无 法 从 请 求 指 定 的 URL 中 找到 客户 端 想 要 的 资源 



























































服务 器 错误 状态 码 。 当 服务 器 因为 某 些 原因 而 无 法 正确 地 处 理 请 求 时 ， 服 务 器 








3XX | 就 会 使 用 这 类 状态 码 来 通知 客户 端 。 在 这 一 类 状态 码 中 ， 最 常见 的 就 是 cse8 


Internal Server Error” 状态 码 了 








1.6.2 ”响应 首部 


啊 应 首部 跟 请 求 首部 一 样 ， 都 是 由 冒号 分 隔 的 纯 文 本 键 值 对 组 成 ， 
并 且 同 样 以 回 车 《CR) 和 换行 CLE) 结尾 。 正 如 请 求 首部 能 够 告诉 服 
务 器 更 多 与 请 求 相 关 或 者 与 客户 端 诉求 相关 的 信息 一 样 ， 啊 应 首部 也 能 
够 向 客户 端 传达 更 多 与 响应 相关 或 者 与 服务 器 《〈 对 客户 端的 ) 诉求 相关 
的 信息 。 表 1-3 展 示 了 一 些 常 见 的 响应 首部 。 











表 1-3 常见 的 啊 应 首部 



































首部 记录 的 就 是 主体 内 容 的 类 型 





























这 个 首部 仅 在 重 定向 时 使 用 ， 它 会 告知 客户 端 接 下 来 应 该 向 哪个 URL 





返回 啊 应 的 服务 器 的 域名 


Set-Cookie 





面 设 置 一 个 cookie。 一 个 响应 里 面 可 以 包含 多 个 Set-Cookie 














服务 器 通过 这 个 首部 来 告知 客户 端 ， 在 Authorization 请 求 首 部 中 应 该 提 
供 哪 种 类 型 的 身份 验证 信息 。 服 务 器 常常 会 把 这 个 首部 与 “461 
Unauthorized” 状态 行 一 同 发 送 。 除 此 之 外 ， 这 个 首部 还 会 向 服务 器 许 


WWW- 


Authenticate 


BY AAG 














授权 模式 (schema) 提供 验证 信息 (challenge information ) 





(比如 RFC 2617 摘 述 的 基本 和 摘要 访问 认证 模式 ) 




















1.7 URI 


Tim Berners-Lee 在 创建 万 维 网 的 同时 ， 也 引入 了 使 用 位 置 字符 串 表 
示 互 联网 资源 的 概念 。 他 在 1994 年 发 表 的 RFC 1630 中 对 统一 资源 标识 符 
(Uniform Resource Identifier, URI) 进行 了 定义 。 在 这 篇 RFC 中 ， 他 插 
述 了 一 种 使 用 字符 串 表 示 资 源 名 字 的 方法 ， 以 及 一 种 使 用 字符 串 表 示 资 
源 所 在 位 置 的 方法 ， 其 中 前 一 种 方法 被 称 为 统一 资源 名 称 〈Uniform 
Resource Name, URN) ， 而 后 一 种 方法 则 被 称 为 统一 资源 定位 符 
(Uniform Resource Location, URL) 。URI 是 一 个 涵盖 性 术语 ， 它 包含 
了 URN 和 URL， 并 且 这 两 者 也 拥有 相似 的 语法 和 格式 。 因 为 本 书 只 会 对 
URL 进 行 讨 论 ， 所 以 本 书 中 提 及 的 URI 指 代 的 都 是 URL。 





URI 的 一 般 格式 为 : 


分 >[ ? “查询 参数 > ] [ # < 片段 > ] 








URI 中 的 方案 名 称 (scheme name) 记录 了 了 URI 下 在 使 用 的 方案 ， 它 
定义 了 URI 其 余部 分 的 结构 。 因 为 URI 是 一 种 非常 常用 的 资源 标识 方 
式 ， 所 以 它 拥有 大 量 的 方案 可 供 使 用 ， 不 过 本 书 在 大 多 数 情况 下 只 会 使 
用 HTTP 方 案 。 





URI 的 分 层 部 分 (hierarchical part) 包含 了 资源 的 识别 信息 ， 这 些 
言 恩 会 以 分 层 的 方式 进行 组 织 。 如 果 分 层 部 分 以 双 斜 线 O) 开头 ， 
那么 说 明 它 包含 了 可 选 的 用 户 信息 ， 这 些 信 息 将 以 @ 符号 结尾 ， 后 跟 分 
层 路 径 。 不 融 用 户 信息 的 分 层 部 分 就 是 一 个 单纯 的 路 径 ， 每 个 路 径 都 由 


一 连 串 的 分 段 (segment) 组 成 ， 各 个 分 段 之 间 使 用 单 斜 线 〈/ ) 分 隔 。 


在 URI 的 各 个 部 分 当中 ， 只 有 “方案 名 称 ” 和 “分 层 部 分 ”是 必需 的 。 
以 问号 (? ) 为 前 级 的 查询 参数 (query) 是 可 选 的 ， 这 些 参数 用 于 包 
含 无 法 使 用 分 层 方式 表示 的 其 他 信息 。 多 个 查询 参数 会 被 组 织 成 一 连 串 
的 键 值 对 ， 各 个 键 值 对 之 间 使 用 & 符号 分 隔 。 





URI 的 男 一 个 可 选 部 分 为 片段 〈fragment) ， 片 段 使 用 井 号 CH) 
作为 前 级 ， 它 可 以 对 URI 定 义 的 资源 中 的 次 级 资源 (secondary 
resource) 进行 标识 。 当 URI 包 含 查 询 参数 时 ，URI 的 片段 将 被 放 到 查询 
参数 之 后 。 因 为 URI 的 片段 是 由 客户 端 负责 处 理 的 ， 所 以 Web 浏 览 器 在 
将 URI 有 友 送 给 服务 右 之 前 ， 一 般 都 会 先 把 URI 中 的 请 段 移 除 反 。 如 果 程 
序 员 想 要 取得 URI 卢 段 ， 那 么 可 以 通过 JavaScript 或 者 某 个 HTTP 客户 端 
库 ， 将 URI 和 片段 包含 在 一 个 GET 请 求 里 面 。 





让 我 们 来 看 一 个 使 用 HTTP 方 案 的 URI 示 例 : 
http://sausheong:password@www.example. com/ docs/file? 


name=sausheong&location=singapore#summary » 





这 个 URI 使 用 的 是 http 方案 ， 跟 在 方案 名 之 后 的 是 一 个 冒号 。 位 于 
@ 符号 之 前 的 分 段 sausheong:password 记录 的 是 用 户 名 和 密码 ， 而 跟 在 
用 户 信 息 之 后 的 www.example.com/docs/file 就 是 分 层 部 分 的 其 余部 分 。 
位 于 分 层 部 分 最 高 层 的 是 服务 器 的 域名 www.example.com， 之 后 跟着 的 
两 个 层 分 别 为 doc 和 file， 每 个 分 层 之 间 都 使 用 单 笠 线 分 隔 。 跟 在 分 层 部 
分 之 后 的 是 以 问号 C) 为 前 级 的 查询 参数 ， 这 个 部 分 包含 了 
name=sausheong 和 location=singapore 这 两 个 键 值 对 ， 键 值 对 之 间 使 用 一 











个 & 符号 连接 。 最 后 ， 这 个 URI 的 末尾 还 带 有 一 个 以 井 号 〈# ) 为 前 绥 
的 片段 。 


因为 每 个 URL 都 是 一 个 单独 的 字符 串 ， 所 以 URL 里 面 是 不 能 够 包含 
空格 的 。 此 外 ， 因 为 问号 (? ) ARS G) 等 符号 在 URL 中 具有 特殊 
的 含义 ， 所 以 这 些 符号 是 不 能 够 用 于 其 他 用 途 的 。 为 了 避 开 这 些 限 制 ， 
我 们 需要 使 用 URL 编 码 来 对 这 些 特殊 符号 进行 转换 (URL 编码 又 称 百 
分 号 编码 ) 。 


RFC 3986 定 义 了 URL 中 的 保留 字符 以 及 非 保 留 字符 ， 所 有 保留 字符 
都 需要 进行 URL 编 码 : URL 编 码 会 把 保留 字符 转换 成 该 字符 在 ASCII 编 
码 中 对 应 的 字 节 值 (byte value〉， 接 着 把 这 个 字 节 值 表示 为 一 个 两 位 长 
的 十 六 进 制 数 字 ， 最 后 再 在 这 个 十 六 进 制 数字 的 前 面 加 上 一 个 百 分 号 
(%) ào 








EU, ASAE EASCIHHIE HAE AN32, EEK EA 
20. Al, AURLAND %20, URLE KA THAR 
RREMANA. EUER POR RAN HIR-SURL LIA, H saul 
sheong 之 间 的 空格 就 被 蔡 换 成 了 %28 : http://www.example.com/docs/file? 





name=sau%20sheong&location=singapore 。 


1.8 HTTP/2 人 简介 


HTTP/2 是 HTTP 协议 的 最 新 版 本 ， 这 一 版 本 对 性 能 非常 关注 。 
HTTP/2 协 议 由 SPDY/2 协 议 改 进而 来 ， 后 者 最 初 是 Google 公 司 为 了 传输 
Web 内 容 而 开发 的 一 种 开放 的 网 络 协议 。 


与 使 用 纯 文 本 方式 表示 的 HITP 1.x 不 同 ，HTTP/2 是 一 种 二 进 制 协 
W: 二 进 制 表 示 不 仅 能 够 让 HTTP/2 的 语法 分 析 变 得 更 为 高 效 ， 还 能 够 
让 协议 变 得 更 为 紧凑 和 健壮 ;但 与 此 同时 ， 对 那些 习惯 了 使 用 HTTP 1.x 
的 开发 者 来 说 ， 他 们 将 无 法 再 通过 telnet 等 应 用 程序 直接 发 送 HTTP/2 报 
文 来 进行 调试 。 





跟 HTTP 1.x 在 一 个 网 络 连 接 里 面 每 次 只 能 发 送 单个 请 求 的 做 法 不 
同 ，HTTP/2 是 完全 多 路 复 用 的 (fully multiplexed) ， 这 意味 着 多 个 请 求 
和 啊 应 可 以 在 同一 时 间 内 使 用 同一 个 连接 。 除 此 之 外 ，HTTP/2 还 会 对 
首部 进行 压缩 以 减少 需要 传送 的 数据 量 ， 并 允许 服务 器 将 啊 应 推送 
(push) 至 客户 端 ， 这 些 措施 都 能 够 有 效 地 提升 性 能 。 











因为 HTTP 的 应 用 范围 是 如 此 的 广泛 ， 对 语法 的 任何 贸然 修改 都 有 
可 能 会 对 已 有 的 Web 造 成 破坏 ， 所 以 尽管 HTTP/2 对 协议 的 通信 性 能 进行 
了 优化 ， 但 它 并 没有 对 HTTP 协 议 本 号 的 语法 进行 修改 : 在 HTTP/2 中 ， 
HTTP 方 法 和 状态 码 等 功能 的 语法 还 是 跟 HTTP 1.1 时 一 样 。 


在 Go 1.6 版 本 中 ， 用 户 在 使 用 HTTPS 时 将 自动 使 用 HTTP/2， 而 Go 
1.6 之 前 的 版 本 则 在 golang.org/x/net/http2 包 里 面 实 现 了 HTTP/2 协 
议 。 本 书 的 第 3 章 将 会 介绍 如 何 使 用 HTTP/2。 


19 Web 应 用 的 各 个 组 成 部 分 


通过 前 面 的 介绍 ， 我 们 知道 了 Web 应 用 就 是 一 个 执行 以 下 任务 的 程 
序 : 

(1) 通过 HTTP 协 议 ， 以 HTTP 请 求 报 文 的 形式 获取 客户 端 输入 ; 

(2) 对 HTTP 请 求 报 文 进行 处 理 ， 并 执行 必要 的 操作 ; 

(3) 生成 HIML， 并 以 HTTP 响应 报 文 的 形式 将 其 返回 给 客户 端 。 


为 了 完成 这 些 任 务 ，Web 应 用 被 分 成 了 处 理 嚣 Chandler) 和 模板 引 


* (template engine) 这 两 个 部 分 。 
1.9.1 ”处理 右 


Web 应 用 中 的 处 理 器 除了 要 接收 和 处 理 客户 并 发 来 的 请 求 ， 还 需要 
调用 模板 引擎 ， 然 后 由 模板 引擎 生成 HTML 并 把 数据 填充 至 将 要 回 传 给 
客户 端的 啊 应 报 文 当中 。 





用 MVC 模 式 来 讲 ， 处 理 器 既是 控制 有 (controller) ， 也 是 模型 
(model) 。 在 理想 的 MVC 模 式 实现 中 ， 控 制 右 应 该 是 “苗条 的 ”， 它 应 
该 只 包含 路 由 《routing) 代码 以 及 HTTP 报 文 的 解 包 和 打包 逻辑 ， 而 模 
型 则 应 该 是 “丰满 的 ”， 它 应 该 包含 应 用 的 逻辑 以 及 数据 。 























模型 -视图 -控制 器 (Model-View-Controller, MVC) 模式 是 编写 Web 应 用 时 常用 的 模式 ， 






































这 个 模式 是 如 此 的 流行 ， 以 至 于 人 们 有 时 候 会 错误 地 把 这 一 模式 当成 了 Web 应 用 开发 本 号。 





实际 上 ，MVC 模 式 最 初 是 在 20 世 纪 70 年 代 末 的 施乐 帕 罗 奥 多 研究 中 心 (Xerox PARC) 被 
引入 到 Smalltalk 语 言 里 面 的 ， 这 一 模式 将 程序 分 成 了 模型 、 视 图 和 控制 器 3 个 部 分 ， 其 中 模型 
用 于 表示 底层 的 数据 ， 而 视图 则 以 可 视 化 的 方式 向 用 户 展示 模型 ， 至 于 控制 器 则 会 根据 用 户 
的 输入 对 模型 进行 修改 。 每 当 模型 发 生变 化 时 ， 视 图 都 会 自动 进行 更 新 ， 从 而 展现 出 模型 的 
最 新 状态 。 






































尽管 MVC 模 式 起 源 于 桌面 开发 ， 但 它 在 编写 Web 应 用 方面 也 流行 了 起 来 一 一 包括 Ruby on 
Rails、CodeIgniter、Play 和 Spring MVC 在 内 的 很 多 Web 应 用 框架 都 把 MVC 用 作 它 们 的 基本 模 
式 。 在 这 些 框架 里 面 ， 模 型 一 般 都 会 通过 结构 (struct) 或 对 象 Cobject) 映射 Cmap) 到 数据 
库 ， 而 视图 则 会 被 泻 染 为 HIML， 至 于 控制 器 则 负责 对 请 求 进行 路 由 ， 并 管理 对 模型 的 访问 。 




































































使 用 MVC 框 架 进 行 Web 应 用 开发 的 新 手 程序 员 常 常会 误 以 为 MVC 模 式 是 开发 Web 应 用 的 
唯一 方法 ， 但 Web 应 用 本 质 上 只 是 一 个 通过 HTTP 协 议 与 用 户 互 动 的 程序 ， 只 要 能 够 实现 这 种 













































































| 互动， 程序 本 身 可 以 使 用 任何 一 种 模式 开发 ， 其 至 不 使 用 模式 也 是 可 以 的 。 








为 了 防止 模型 变 得 过 于 及 和 肿 ， 并 且 出 于 代码 复 用 的 需要 ， 开 发 者 有 
时 候 会 使 用 服务 对 象 (service object) 或 者 函数 (function) 对 模型 进 
行 操 作 。 尽 管 服务 对 象 严格 来 说 并 不 是 MVC 模 式 的 一 部 分 ， 但 是 通过 
把 相同 的 逻辑 放置 到 服务 对 象 里 面 ， 并 将 同一 个 服务 对 象 应 用 到 不 同 的 
模型 之 上 ， 可 以 有 效 地 避免 在 多 个 模型 里 面 复制 相同 代码 的 窘境 。 


正如 之 前 所 说 ，Web 应 用 并 不 是 一 定 要 用 MVC 模 式 进 行 开发 一 一 通 
过 将 控制 器 和 模型 进行 合并 ， 然 后 由 处 理 器 直接 执行 所 有 操作 并 问 客 户 
端 返回 响应 的 做 法 不 仅 是 可 行 的， 而 且 也 是 十 分 合理 的 。 


1.9.2 ”模板 引擎 


通过 HTTP 响 应 报 文 回 传 给 客户 端的 HTML 是 由 模板 (template) 转 
换 而 成 的 ， 模 板 里 面 可 能 会 包含 HTML， 但 也 可 能 不 会 ， 而 模板 引擎 








(template engine) 则 通过 模板 和 数据 来 生成 最 终 的 HIML。 正 如 之 前 所 
说 ， 模 板 引 擎 是 经 由 早期 的 SSI 技 术 演变 而 来 的 。 








模板 可 以 分 为 静态 模板 和 动态 模板 两 种 ， 这 两 种 模板 都 有 各 目的 设 


WS. 


。 静态 模板 是 一 些 夹杂 着 占 位 符 的 HTML， 静 态 模 板 引 苟 通 过 将 静态 
模板 中 的 占 位 符 蔡 换 成 相应 的 数据 来 生成 最 终 的 HIML， 这 种 做 法 
和 SSI 技 术 的 概念 非常 相似 。 因 为 静态 模板 通常 不 包含 任何 逻辑 代 
码 ， 又 或 者 只 包含 少量 逻辑 代码 ， 所 以 这 种 模板 也 称 为 无 馆 辑 模 
板 。CTemplate 和 Mustache 都 属于 静态 模板 引擎 

动态 模板 除了 包含 HIML 和 占 位 符 之 外 ， 还 包含 一 些 编程 语言 结 
构 ， 如 条 件 语句 、 和 迭代 语句 和 变量 。JavaServer Pages (JSP) 、 
Active Server Pages (ASP) 和 Embedded Ruby (ERB) 都 属于 动态 
模板 引擎 。PHP 刚 诞生 的 时 候 看 上 去 也 像 是 一 种 动态 模板 ， 它 是 之 
后 才 逐 渐 演 变 成 一 门 编程 语言 的 。 











到 目前 为 止 ， 本 章 已 经 介绍 了 很 多 Web 应 用 背后 的 基础 知识 以 及 原 
理 。 初 看 上 去 ， 这 些 内 容 可 能 会 显得 过 于 琐碎 了 ， 但 随 着 读者 对 本 书 内 
容 的 不 断 深 入 ， 理 解 这 些 基础 知识 的 重要 性 就 会 慢 慢 地 显现 出 来 。 在 了 
解 了 Web 应 用 开发 所 需 的 基本 知识 之 后 ， 现 在 是 时 候 进 入 下 一 个 阶段 
一 一 开始 实际 地 进行 Go 编程 了 。 在 接 下 来 的 一 节 ， 我 们 将 开始 学 习 如 
何 使 用 Go 开发 Web 应 用 。 





1.10 Hello Go 


在 这 一 他， 我 们 将 开始 学 习 如 何 实际 地 使 用 Go 语言 构建 Web 应 用 。 
如 果 你 还 没有 安装 Go， 那 么 请 先 阅 读本 书 的 附录 ， 根 据 附录 中 的 指示 
安装 Go 并 设置 相关 的 环境 变量 。 本 节 在 构建 Web 应 用 时 将 会 用 到 Go 的 
net/http 包 ， 因 为 本 书 将 会 在 接 下 来 的 几 章 中 对 这 个 包 进 行 详细 的 介 
绍 ， 所 以 即使 目前 对 这 个 包 知 之 甚 少 ， 也 不 必 过 于 担心 。 目 前 来 说 ， 你 
只 需要 在 电脑 上 键入 本 节 展 示 的 代码 ， 编 译 它 ， 然 后 观察 这 些 代 码 是 如 
何 运 行 的 就 可 以 了 。 习 惯 了 使 用 大 小 写 无 天 编程 语言 的 读者 请 注意 ， 
为 Go 语言 是 区 分 大 小 写 的 ， 所 以 在 键入 本 书展 示 的 代码 时 请 务必 注意 
代码 的 大 小 写 。 


























本 书展 示 的 所 有 代码 都 可 以 在 这 个 GitHub 页 面 找到 : 
https://github.com/sausheong/gwp. 


请 在 你 的 工作 空间 的 src 目录 中 创建 一 个 first_webapp 子 目录 ， 
并 在 这 个 子 目 录 里 面 创建 一 个 server .go 文件 ， 然 后 将 代码 清单 1-1 中 
展示 的 源 代码 键入 到 文件 里 面 。 








代码 清单 1-1 使 用 Go 构建 的 Hello World Web 应 用 








package main 


import ( 
"Fmt! 
"net/http" 
) 


func handler(writer http.ResponseWriter, request *http.Request) { 
fmt.Fprintf(writer, "Hello World, %s!", request.URL.Path[1: ]) 


} 


func main() { 
http.HandleFunc("/", handler) 
http.ListenAndServe(":8080", nil) 
} 





在 一 切 就 绪 之 后 ， 请 打开 你 的 终端 ， 执 行 以 下 命令 : 


$ go install first_webapp 





你 可 以 在 任意 目录 中 执行 这 个 命令 。 在 正确 地 设置 了 GOPATH 环境 
变量 的 情况 下 ， 这 个 命令 将 在 你 的 $GOPATH/bin 目录 中 创建 一 个 名 
Afirst_webapp 的 二 进 制 可 执行 文件 ， 接 着 就 可 以 在 终端 里 面 运行 这 
个 文件 了 。 如 果 你 按照 附录 的 指示 ， 将 $GOPATH/bin 目录 也 添加 到 了 
PATH 环境 变量 当中 ， 那 么 你 也 可 以 在 任意 目录 中 执行 first_webapp 
文件 。 被 执行 的 first_webapp 文件 将 在 系统 的 8080 端 口上 局 动 你 的 
Web 应 用 。 一 切 就 这 么 简单 ! 


现在 ， 打 开 网 页 浏览 器 ， 访 问 http://localhost:8080/。 如 果 一 切 正 
常 ， 那 么 你 将 会 看 到 图 1-3 所 示 的 内 容 。 


© | http://localhost:8080/ x | + 


(€) © localhost:8080 Cc = 


Hello World, ! 


图 1-3 ”我 们 创建 的 首 个 web 应 用 








让 我 们 来 仔细 地 分 析 一 下 这 个 Web 应 用 的 代码 。 第 一 行 代 码 声 明了 
这 个 程序 所 属 的 包 ， 跟 在 package 关键 字 之 后 的 main 就 是 包 的 名 字 。 
Go 语言 要 求 可 执行 程序 必须 位 于 main 包 当 中 ，Web 应 用 也 不 例外 。 如 
果 你 曾经 使 用 过 Ruby、Python 或 者 Java 等 其 他 编程 语言 来 开 用 Web 应 
用 ， 那 么 你 可 能 已 经 发 现 了 Go 和 这 些 语言 之 间 的 区 别 : 其 他 语言 通常 
需要 将 Web 应 用 部 署 到 应 用 服务 器 上 面 ， 并 由 应 用 服务 器 为 Web 应 用 提 
供 运 行 环境 ， 但 是 对 Go 来 说 ，Web 应 用 的 运行 环境 是 由 net/http 包 直 
接 提供 的 ， 这 个 包 和 应 用 的 源 代码 会 一 起 被 编译 成 一 个 可 以 快速 部 署 的 
独立 Web 应 用 。 











it package 语句 之 后 的 Import 语句 用 于 导入 所 需 的 包 : 


"net/http" 





被 导入 的 包 分 别 为 fmt 包 和 http 包 ， 前 者 使 得 程序 可 以 使 
用 Fprintf 等 函数 对 MO 进行 格式 化 ， 而 后 者 则 使 得 程序 可 以 与 HITP 进 
行 交 互 。 顺 带 一 提 ，Go 的 ijmport 语句 不 仅 可 以 导入 标准 库 里 面 的 包 ， 
还 可 以 从 第 三 方 库 里 面 导 入 包 。 











出 现在 导入 语句 之 后 的 是 一 个 函数 定义 : 


func handler(writer http.ResponseWriter, request *http.Request) { 
fmt.Fprintf(writer, "Hello World, %s!", request.URL.Path[1:]) 


} 





这 3 行 代码 定义 了 一 个 名 为 handler 的 函数 。 处 理 器 Chandler ) 这 
个 名 字 通 常用 来 表示 在 指定 事件 被 触发 之 后 ， 负 责 对 事件 进行 处 理 的 回 
调 函 数 ， 这 也 正 是 我 们 如 此 命名 这 个 函数 的 原因 《不 过 从 技术 上 来 说 ， 
至 少 在 Go 语言 里 面 ， 这 个 函数 并 不 是 一 个 处 理 器 ， 而 是 一 个 处 理 器 函 
数 ， 处 理 器 和 处 理 器 函数 之 间 的 区 别 将 在 第 3 章 中 介绍 ) 。 








这 个 处 理 器 函数 接受 两 个 参数 作为 输入 ， 第 一 个 参数 
为 ResponseWriter 接口 ， ERE 吉 构 的 指 
ło handler È a 吉 构 中 提取 相关 的 信息 ， 然 后 创建 一 个 
HTTP 响 应 ， 最 后 再 通过 ResponseWriter 接口 将 响应 返回 给 客户 端 


至 于 handler 函数 内 部 的 Fprintf 函数 在 被 调用 时 则 会 使 用 一 

个 ResponseWriter 接口 、 一 个 带 有 单个 格式 化 指示 符 (%s ) 的 格式 
化 字符 串 以 及 从 Request 结构 里 面 提取 到 的 路 径 信 息 作 为 参数 。 因 为 我 
们 之 前 访问 的 地 址 为 http://localhost:8080/， 所 以 应 用 并 没有 打印 出 任何 
路 径 信 息 ， 但 如 果 我 们 访问 地 址 
http://localhost:8080/sausheong/was/here， 那 么 浏览 器 应 该 会 展示 出 图 1-4 
所 示 的 信息 。 





Go 语言 规定 ， 每 个 需要 被 编译 为 二 进 制 可 执行 文件 的 程序 都 必须 
包含 一 个 main 函数 ， 用 作 程 序 执行 时 的 起 点 : 


func main() { 
http.HandleFunc("/", handler) 
http.ListenAndServe(":8@80", nil) 








这 个 main 函数 的 作用 非常 直观 ， 它 首先 把 之 前 定义 的 handler K 
数 设 置 成 根 Croot) URL 〈/ ) 被 访问 时 的 处 理 器 ， 然 后 启动 服务 器 并 
让 它 监 听 系 统 的 8080 端 口 〈 按 下 Cal+C 可 以 停止 这 个 服务 器 ) 。 至 此 ， 
这 个 使 用 Go 语言 编写 的 Hello World Web 应 用 就 算 顺利 完成 了 。 





© | http://localhost...usheong/was/here > \ 十 
| (€) @ localhost:8080/sausheong/was/here Š 











Hello World, sausheong/was/here! 





图 1-4 带 有 路 径 信息 的 Hello World 示 例 


本 章 以 介绍 Web 应 用 的 基础 知识 开始 ， 并 最 终 走马 观 花 地 编写 了 一 
个 简单 却 没什么 用 处 的 Go Web 应 用 作为 结束 。 在 接 下 来 的 一 章 中 ， 我 
们 将 会 看 到 更 多 代码 ， 并 学 习 如 何 使 用 Go 语言 以 及 它 的 标准 库 去 编写 
更 真实 的 Web 应 用 (不 过 这 些 应 用 距离 真正 生产 级 别 的 应 用 还 有 一 定 距 
离 ) 。 尽 管 第 2 章 出 现 的 大 量 代码 可 能 会 让 读者 有 一 种 圆 轿 厨 吏 的 感 
党 ， 但 我 们 将 会 从 中 学 习 到 一 个 典型 的 Go Web 应 用 是 如 何 组 织 的 。 














1.11 小 结 








使 用 Go 开发 的 Web 应 用 不 仅 具 有 可 扩展 、 模 块 化 和 可 维护 等 特性 ， 
而 且 使 用 Go 还 能 够 更 容易 地 开发 出 性 能 更 高 的 应 用 ， 因 此 Go 是 一 
门 非常 适合 进行 Web 开 发 的 编程 语言 。 

因为 Web 应 用 是 一 种 通过 HTTP 协 议 向 客户 端 返回 HTML 的 程序 ， 
所 以 理解 HTTP 协议 对 学 习 Web 应 用 开发 来 说 是 相当 重要 的 。 
HTTP 是 一 种 简单 、 无 状态 、 纯 文本 的 客户 端 -服务 器 协议 ， 它 用 于 
在 客户 端 和 服务 器 之 间 进 行 数据 交换 。 

HTTP 的 请 求 和 啊 应 都 以 相同 的 格式 进行 组 织 一 一 它们 首先 以 一 个 
请 求 行 或 者 响应 行 作 为 开始 ， 接 着 后 跟 一 个 或 多 个 首部 ， 最 后 还 有 
一 个 可 选 的 主体 。 

每 个 HTTP 请 求 都 有 一 个 请 求 行 ， 请 求 行 里 面包 含 一 个 HTTP 方 法 ， 
HTTP 方 法 标示 了 请 求 想 要 让 服务 器 执行 的 动作 。GET 方法 和 POST 
方法 是 最 常用 的 两 个 HTTP 方 法 。 

每 个 HTTP 啊 应 都 有 一 个 响应 行 ， 啊 应 行 会 告知 客户 端 请 求 的 执行 
状态 。 

任何 Web 应 用 都 包含 处 理 器 和 模板 引擎 ， 这 两 个 主要 部 分 分 别 与 
HTTP 协 议 的 请 求 和 啊 应 相对 应 。 

处 理 器 负责 接收 HTTP 请 求 并 处 理 它们 。 

模板 引擎 负责 生成 HTML， 这 些 HTML 之 后 会 作为 HTTP 响 应 的 其 中 
一 部 分 被 回 传 至 客户 端 。 

















第 2 章 ChitChat iz 


本 章 主要 内 容 


。 使 用 Go 进行 Web 编 程 的 方法 
。 设计 一 个 典型 的 Go Web 应 用 
。 编写 一 个 完整 的 Go Web 应 用 
。 了 解 Go Web 应 用 的 各 个 组 成 部 分 


上 一 章 在 末尾 展示 了 一 个 非常 简单 的 Go Web 应 用 ， 但 是 因为 该 应 
用 只 是 一 个 Hello World 程 序 ， 所 以 它 实际 上 并 没有 什么 用 处 。 在 本 章 
中 ， 我 们 将 会 构建 一 个 简单 的 网 上 论坛 Web 应 用 ， 这 个 应 用 同样 非常 基 
础 ， 但 是 却 有 用 得 多 : 它 允 许 用 户 登 录 到 论坛 里 面 ， 然 后 在 论坛 上 发 布 
新 帖子 ， 又 或 者 回复 其 他 用 户 发 表 的 帖子 。 








虽然 本 章 介 绍 的 内 容 无 法 让 你 一 下 子 就 学 会 如 何 编写 一 个 非常 成 熟 
的 web 应 用 ， 但 这 些 内 容 将 教会 你 如 何 组 织 和 开发 一 个 Web 应 用 。 在 阅 
读 完 这 一 章 之 后 ， 你 将 进一步 地 了 解 到 使 用 Go 进行 Web 应 用 开发 的 相关 
TB 











BOER UB GE FS AS ENTE PEEK, SBT PR AS AS Be RAN AK 
量 代 码 看 起 来 让 人 和 沉 得 胆 战 心 怀 ， 那 也 不 必 过 于 担心 : 本 章 之 后 的 几 章 
将 对 本 章 介 绍 的 内 容 做 进一步 的 解释 ， 在 阅读 完 本 章 并 继续 阅读 后 续 章 
节 时 ， 你 将 会 对 本 章 介绍 的 内 容 有 更 加 深入 的 了 解 。 


2.1 ” ChitChat 简介 





网 上 论坛 无 处 不 在 ， 它 们 是 互联 网 上 最 受 欢 迎 的 应 用 之 一 ， 与 旧式 
的 电子 公告 栏 (BBS) 、 新 闻 组 (Usenet〉 和 电子 邮件 一 脉 相 承 。 雅 虎 
公司 和 Google 公 司 的 群 组 〈Groups) 都 非常 流行 ， 雅 虎 报 告 称 ， 他 们 总 
共 拥 有 1000 万 个 群 组 以 及 1.15 亿 个 群 组 成 员 ， 其 中 每 个 群 组 都 拥有 一 个 
自己 的 论坛 ， 而 全 球 最 具 人 气 的 网 上 论坛 之 一 一 一 Gaia 在 线 一 一 则 拥有 
2300 万 注册 用 户 以 及 接近 230 亿 张 帖子 ， 并 且 这 些 帖子 的 数量 还 在 以 每 
天 上 百 万 张 的 速度 持续 增长 。 尽 省 现在 出 现 了 诸如 Facebook 这 样 的 社交 
网 站 ， 但 论坛 仍然 是 人 们 在 网 上 进行 交流 时 最 为 常用 的 手段 之 一 。 作 为 
例子 ， 图 2-1 展 示 了 GoogleGroups 的 样子 。 








eee < 局 groups.googie.com/forumy #!forum/golang-nuts v 由 + 
Google -EE o S 
Groups CG Mark all as read Filters ~ op a + 


» golang-nuts Shared publicly 


60 of 20102 topics (99+ unread) * a About 


| El Unserializing interface types with json (4) 4posts 12:55 
© Extended logic in golang text/templates (2) 2 12:54 

* 加 Problem with custom types using Postgresq! (1) 1 11:45 
DJ How to organize a go project that also includes other languages? (1) 1 11:23 

El How to compile golang functions as a static library or a dynamic to explode to object-c? (2) 2 08:04 

E] FireBird connection (2) 2 08:01 

©) Can we call a GO function/library in JAVA code? (4) 4 07:49 

El Goin Action vs Programming in Go (5) 5 05:57 

El GPL licensed go software (3) 3 04:34 
Dl Announcing gsoup: an HTML sanitizer (and some questions) (2) 2 04:00 

广 Dl Which web framework is recommended to use with GO? (9) 9 02:05 
El beginner : best way to learn go (3) 3 00:45 

* E [RFC] Watching err with “watch” Expression Block [RFC] (14) 14 17 Jan 
* Dl Go runtime - GOMAXPROCs and threads (4) 4 17 Jan 
©) Poor performance reading stdin (40) 40 17 Jan 

t Dl time.Parse of two reference times aren't equal (7) 7 17 Jan 
©) Capitalization of fields in private structs (16) 16 17 Jan 

EJ reaching for sync.WaitGroup feels wrong... (24) 24 17 Jan 

* Bl How do |! verify an xmi document containing a signature and X.509 data? (7) 7 17 Jan 
El Go 1.4.1 is released (10) 10 17 Jan 

* D How to read *.xIs file using golang (3) 3 17 Jan 


图 2-1 一 个 网 上 论坛 示例 : GoogleGroups 里 面 的 Go 编程 语言 论坛 


从 本 质 上 来 说 ， 网 上 论坛 就 相当 于 一 个 任何 人 都 可 以 通过 发 帖 来 进 
行 对 话 的 公告 板 ， 公 告 板 上 面 可 以 包含 已 注册 用 户 以 及 未 注册 的 匿名 用 
户 。 论 坛 上 的 对 话 称 为 帖子 (thread) ， 一 个 帖子 通常 包含 了 作者 想 要 
讨论 的 一 个 主题 ， 而 其 他 用 户 则 可 以 通过 回复 这 个 帖子 来 参与 对 话 。 比 
较 复杂 的 论坛 一 般 部 会 按 层级 进行 划分 ， 在 这 些 论坛 里 面 ， 可 能 会 有 多 
个 讨论 特定 类 型 主题 的 子 论坛 存在 。 大 多 数论 坛 都 会 由 一 个 或 多 个 拥有 
特殊 权限 的 用 户 进行 管理 ， 这 些 拥有 特殊 权限 的 用 户 被 称 为 版 主 


(moderator) 。 





在 本 章 中 ， 我 们 将 会 开发 一 个 名 为 ChitChat 的 简易 网 上 论坛 。 为 了 
让 这 个 例子 保持 简单 ， 我 们 只 会 为 ChitChat 实 现 网 上 论坛 的 关键 特性 : 
在 这 个 论坛 里 面 ， 用 户 可 以 注册 账号 ， 并 在 登录 之 后 发 表 新 帖子 又 或 者 
回复 己 有 的 帖子 ， 未 注册 用 户 可 以 查看 帖子 ， 但 是 无 法 发 表 帖 子 或 是 回 
复 帖 子 。 现 在， 让 我 们 首先 来 思考 一 下 如 何 设计 ChitChat 这 个 应 用 。 








量 关于 本 章 展示 的 代码 











跟 本 书 的 其 他 章节 不 一 样 ， 因 为 篇 幅 的 关系 ， 本 章 并 不 会 展示 ChitChat 论 坛 的 所 有 实现 代 
码 ， 但 你 可 以 在 GitHub 页 面 https://github.com/sausheong/gwp 找 到 这 些 代 码 。 如 果 你 打算 在 阅读 
本 章 的 同时 实际 了 解 一 下 这 个 应 用 ， 那 么 这 些 完整 的 代码 应 该 会 对 你 有 所 帮助 。 
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正如 第 1 章 所 说 ，Web 应 用 的 一 般 工 作 流 程 是 客户 端 向 服务 器 发 送 
请 求 ， 然 后 服务 器 对 客户 端 进行 啊 应 《〈 如 图 2-2 所 示 ) ，ChitChat 应 用 的 
设计 也 遵循 这 一 流程 。 


1. 发 送 HTTP 请 求 2. 处 理 HTTP 请 求 





3. 返回 HTTP 响 应 


图 2-2 ”Web 应 用 的 一 般 工 作 流 程 ， 客 户 端 向 服务 器 发 送 请 求 ， 然 后 等 待 接收 啊 应 





ChitChat 的 应 用 逻辑 会 被 编码 到 服务 器 里 面 。 服 务 吉 会 回 客 户 端 提 
供 HIML 页 面 ， 并 通过 页 面 的 超 链接 辐 客 户 端 表 明 请 求 的 格式 以 及 被 请 
求 的 数据 ， 而 客户 端 则 会 在 发 送 请 求 时 癌 服 务 吉 提供 相应 的 数据 ， 如 图 
2-3 所 示 。 





服务 器 会 通过 HTML 页 面 上 的 超 链 
接 ， 向 Web 应 用 表明 请 求 的 格式 。 


http://<servername>/<handlername>?<parameters> 


请 求 
客户 端 服务 器 
响应 


图 2-3 ” HTTP 请求 的 URL 格 式 























请 求 的 格式 通常 是 由 应 用 自行 决定 的 ， 比 如 ，ChitChat 的 请 求 使 用 
的 是 以 下 格式 : http://< 服 务 器 名 >< 处 理 器 名 >?< 参 数 > 。 


服务 器 名 ( server name) 是 ChitChat 服 务 器 的 名 字 ， 而 处 理 器 名 
Chandler name) 则 是 被 调用 的 处 理 器 的 名 字 。 处 理 器 的 名 字 是 按 层级 
进行 划分 的 : 位 于 名 字 最 开头 是 被 调用 模块 的 名 字 ， 而 之 后 跟着 的 则 是 
被 调用 子 模块 的 名 字 ， 以 此 类 推 ， 位 于 处 理 器 名 字 最 末尾 的 则 是 子 模块 
中 负责 处 理 请 求 的 处 理 器 。 比 如 ， 对 /thread/read 这 个 处 理 器 名 字 来 
说 ，thread 是 被 调用 的 模块 ， 而 read 则 是 这 个 模块 中 负责 读 取 帖 子 内 
容 的 处 理 器 。 





该 应 用 的 参数 (parameter) 会 以 URL 查 询 的 形式 传递 给 处 理 占 ， 
而 处 理 器 则 会 根据 这 些 参数 对 请 求 进行 处 理 。 比 如 说 ， 假 设 客户 端 要 回 
处 理 器 传递 帖子 的 唯一 JD， 那 么 它 可 以 将 URL 的 参数 部 分 设置 
成 id=123 ， 其 中 123 就 是 帖子 的 唯一 ID。 


如 果 chitchat 就 是 ChitChat 服 务 器 的 名 字 ， 那 么 根据 上 面 介 绍 的 
URL 格 式 规 则 ， 客 户 端 发 送 给 ChitChat 服 务 器 的 URL 可 能 会 是 这 样 的 : 
http://chitchat/thread/read?id=123. 


“REARS aI, SERS Aas (multiplexer) 会 对 请 求 进行 检 
查 ， 并 将 请 求 重 定向 至 正确 的 处 理 器 进行 处 理 。 处 理 器 在 接收 到 多 路 复 
用 器 转发 的 请 求 之 后 ， 会 从 请 求 中 取出 相应 的 信息 ， 并 根据 这 些 信息 对 
请 求 进行 处 理 。 在 请 求 处 理 完毕 之 后 ， 处 理 右 会 将 所 得 的 数据 传递 给 模 
板 引 擎 ， 而 模板 引 苟 则 会 根据 这 些 数 据 生成 将 要 返回 给 客户 端的 
HTML， 整 个 过 程 如 图 2-4 所 示 。 








多 路 复 用 器 会 对 URL 请 求 
进行 检查 ， 并 将 它 重 定向 
至 正确 的 处 理 器 。 


处 理 器 会 向 模板 


STE 























图 2-4 ”服务 器 在 典型 Web 应 用 中 的 工作 流程 








2.3 ”数据 模型 


绝 大 多 数 应 用 都 需要 以 茶 种 方式 与 数据 打交道 。 对 ChitChat 来 说 ， 
它 的 数据 将 被 存储 到 关系 式 数 据 库 PostgreSQL 里 面 ， 并 通过 SQL 与 之 交 
Ha 


ChitChat 的 数据 模型 非常 简单 ， 只 包含 4 种 数据 结构 ， 它 们 分 别 是 : 


User 





表示 论坛 的 用 户 信 息 ; 

Session 一 一 表示 论坛 用 户 当 前 的 登录 会 话 ; 

Thread 一 一 表示 论坛 里 面 的 帖子 ， 每 一 个 帖子 都 记录 了 多 个 论坛 用 
户 之 间 的 对 话 ; 

表示 用 户 在 帖子 里 面 添加 的 回复 。 














Post 





以 上 这 4 种 数据 结构 都 会 被 映射 到 关系 数据 库 里 面 ， 图 2-5 展 示 了 这 
4 种 数据 结构 是 如 何 与 数据 库 交 互 的 。 





ChitChat 论 坛 允许 用 户 在 登录 之 后 发 布 新 帖子 或 者 回复 已 有 的 帖 
子 ， 未 登录 的 用 户 可 以 阅读 帖子 ， 但 是 不 能 发 布 新 帖子 或 者 回复 帖子 。 
为 了 对 应 用 进行 简化 ，ChitChat 论 坛 没 有 设置 版 主 这 一 职位 ， 因 此 用 户 
在 发 布 新 帖子 或 者 添加 新 回复 的 时 候 不 需要 经 过 审核 。 





图 2-5 ”Web 应 用 访问 数据 存储 系统 的 流程 


在 了 解 了 ChitChat 的 设计 方案 之 后 ， 现 在 可 以 开始 考虑 具体 的 实现 
代码 了 。 在 开始 学 习 ChitChat 的 实现 代码 之 前 ， 请 注意 ， 如 果 你 在 阅读 
本 章 展 示 的 代码 时 过 到 困难 ， 叉 或 者 你 是 刚 开 始 学 习 Go 语 言 ， 那 么 为 
了 更 好 地 理解 本 章 介 绍 的 内 容 ， 你 可 以 考虑 先 花 些 时 间 阅 读 一 本 Go 语 
言 的 编程 入 门 书 ， 比 如 ， 由 William Kennedy. Brian Ketelsen 和 Erik St. 
Martin 撰 号 的 《Go 语言 实战 》 束 是 一 个 很 不 错 的 选择 。 


除 此 之 外 ， 在 阅读 本 章 时 也 请 尽量 保持 耐性 ， 本 章 只 是 从 宏观 的 角 
度 展示 Go Web 应 用 的 样子 ， 并 没有 对 Web 应 用 的 细 市 作 过 多 的 解释 ， 
而 是 将 这 些 细 市 留 到 之 后 的 革 节 再 进一步 说 明 。 在 有 需要 的 情况 下 ， 本 
章 也 会 在 介绍 某 种 技术 的 同时 ， 说 明 在 哪 一 章 可 以 找到 这 一 技术 的 更 多 
相关 信息 。 





2.4 请 求 的 接收 与 处 理 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 正 如 之 前 所 说 ，Web 应 
用 的 工作 流程 如 下 。 


(1) 客户 剖 将 请 求 发 送 到 服务 如 的 一 个 URL 上 。 


(2) 服务 器 的 多 路 复 用 器 将 接收 到 的 请 求 重 定 癌 到 正确 的 处 理 
恬 ， 然 后 由 该 处 理 絮 对 请 求 进行 处 理 。 


(3) 处 理 需 处 理 请 求 并 执行 必要 的 动作 。 


(4) 处 理 需 调用 模板 引擎 ， 生 成 相应 的 HTML 并 将 其 返回 给 客户 


让 我 们 先 从 最 基本 的 根 URL (/ ) 来 考虑 Web 应 用 是 如 何 处 理 请 求 
: 当 我 们 在 浏览 器 上 输入 地 址 http://Localhost 的 时 候 ， 浏 览 器 访 
问 的 就 是 应 用 的 根 URL。 在 接 下 来 的 几 个 小 节 里 面 ， 我 们 将 会 看 到 
ChitChat 是 如 何 处 理发 送 至 根 URL 的 请 求 的 ， 以 及 它 又 是 如 何 通 过 动态 
地 生成 HTML 来 对 请 求 进行 啊 应 的 。 


2.4.1 多 路 复 用 器 


因为 编译 后 的 二 进 制 Go 应 用 总 是 以 main 函数 作为 执行 的 起 点 ， 所 
以 我 们 在 对 Go 应 用 进行 介绍 的 时 候 也 总 是 从 包含 main 函数 的 主 源码 文 
件 (main source code file〉 开 始 。ChitChat 应 用 的 主 源码 文件 为 main. go 
， 代 码 清单 2-1 展 示 了 它 的 一 个 简化 版 本 。 


reas 








代码 清单 2-1 main. go 文件 中 的 main 函数 ， 函 数 中 的 代码 经 过 了 简化 








package main 

import ( 
"net/http" 

) 


func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir("/public")) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 


mux.HandleFunc("/", index) 


server := &http.Server{ 
Addr: "@.0.0.0:8080", 
Handler: mux, 


} 


server.ListenAndServe() 


} 





main.go 中 首先 创建 了 一 个 多 路 复 用 器 ， 然 后 通过 一 些 代 码 将 接收 
到 的 请 求 重 定向 到 处 理 器 。net/http 标准 库 提 供 了 一 个 默认 的 多 路 复 
用 器 ， 这 个 多 路 复 用 器 可 以 通过 调用 NewserveMux 函数 来 创建 : 


mux := http.NewServeMux() 


为 了 将 发 送 至 根 URE 的 请 求 重 定向 到 处 理 器 ， 程 序 使 用 了 
HandleFunc 函数 : 


mux.HandleFunc("/", index) 


HandleFunc 函数 接受 一 个 URL 和 一 个 处 理 器 的 名 字 作 为 参数 ， 并 
将 针对 给 定 URL 的 请 求 转发 至 指定 的 处 理 器 进行 处 理 ， 因 此 对 上 述 调用 
来 说 ， 当 有 针对 根 URL 的 请 求 到 达 时 ， 该 请 求 就 会 被 重 定向 到 名 
为 index 的 处 理 器 函数 。 此 外 ， 因 为 所 有 处 理 器 都 接受 一 
个 ResponseWriter 和 一 个 指向 Request 结构 的 指针 作为 参数 ， 并 且 所 
有 请 求 参数 都 可 以 通过 访问 Request 结构 得 到 ， 所 以 程序 并 不 需要 向 处 
理 器 显 式 地 传 入 任何 请 求 参 数 。 








需要 注意 的 是 ， 前 面 的 介绍 模糊 了 处 理 器 以 及 处 理 器 函数 之 间 的 区 
Al: 我 们 刚 开 始 谈论 的 是 处 理 器 ， 而 现在 谈论 的 却 是 处 理 器 函数 。 这 是 
意 而 为 之 的 一 一 尽管 处 理 器 和 处 理 器 函数 提供 的 最 终结 果 是 一 样 的 ， 
但 它们 实际 上 并 不 相同 。 本 书 的 第 3 章 将 对 处 理 器 和 处 理 器 函数 之 间 的 
区 别 做 进一步 的 说 明 ， 但 是 现在 让 我 们 暂时 先 忘 掉 这 件 事 ， 继 续 研 究 
ChitChat 应 用 的 代码 实现 。 


2.4.2 ”服务 静态 文件 


除 负 责 将 请 求 重 定向 到 相应 的 处 理 器 之 外 ， 多 路 复 用 器 还 需要 为 静 
态 文件 提供 服务 。 为 了 做 到 这 一 点 ， 程 序 使 用 FileServer 函数 创建 了 
一 个 能 够 为 指定 目录 中 的 静态 文件 服务 的 处 理 器 ， 并 将 这 个 处 理 器 传递 
给 了 多 路 复 用 器 的 Handle 函数 。 除 此 之 外 ， 程 序 还 使 用 StripPrefix 
函数 去 移 除 请 求 URL 中 的 指定 前 级 : 


files := http.FileServer(http.Dir("/public")) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 





当 服 务 器 接收 到 一 个 以 /staticy 开头 的 UREL 请 求 时 ， 以 上 两 行 代 
码 会 移 除 URL 中 的 /static/ 字符 串 ， 然 后 在 public 目录 中 会 找 被 请 求 
的 文件 。 比 如 说 ， 当 服务 器 接收 到 一 个 针对 文件 
http://localhost/static/css/bootstrap.min.css 的 请 求 时 ， 它 
将 会 在 public 目录 中 查找 以 下 文件 : 


<application root>/css/bootstrap.min.css 


当 服 务 器 成 功 地 找到 这 个 文件 之 后 ， 会 把 它 返 回 给 客户 端 。 


2.4.3 ”创建 处 理 器 函数 


正如 之 前 的 小 节 所 说 ，ChitChat 应 用 会 通过 HandleFunc 函数 把 请 
求 重 定向 到 处 理 器 函数 。 正 如 代码 清单 2-2 所 示 ， 处 理 器 函数 实际 上 就 
是 一 个 接受 ResponseWriter 和 Request 指针 作为 参数 的 Go 函数 。 

















代码 清单 2-2 main. go 文件 中 的 index 处 理 器 函数 











func index(w http.ResponseWriter, r *http.Request) { 
files := []string{"templates/layout.html1", 
"templates/navbar.html", 
"templates/index.htm1", } 
templates := template.Must(template.ParseFiles(files...)) 


threads, err := data.Threads(); if err == nil { 
templates.ExecuteTemplate(w, "layout", threads) 
} 
} 





index 函数 负责 生成 HIML 并 将 其 写 入 ResponseWriter 中 。 因 为 


函数 负 
这 个 处 理 器 函数 会 用 到 html/template 标准 库 中 的 Template 结构 ， 所 


以 包含 这 个 函数 的 文件 需要 在 文件 的 开头 导入 htm1/template 库 。 
之 后 的 小 节 将 对 生成 HIML 的 方法 做 进一步 的 介绍 。 


除了 前 面 提 到 过 的 负责 处 理 根 URL 请 求 的 ijndex AbEE 4s PKI 
数 ，main.go 文件 实际 上 还 包含 很 多 其 他 的 处 理 器 函数 ， 如 代码 清单 2- 
3 所 示 。 





代码 清单 2-3 ”ChitChat 应 用 的 main. go 源 文件 








package main 


import ( 
"net/http" 
) 


func main() { 


mux := http.NewServeMux() 
files := http.FileServer(http.Dir(config.Static)) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 


mux.HandleFunc("/", index) 
mux.HandleFunc("/err", err) 


mux.HandleFunc("/login", login) 
mux.HandleFunc("/logout", logout) 
mux.HandleFunc("/signup", signup) 
mux.HandleFunc("/signup_account", signupAccount) 
mux.HandleFunc("/authenticate", authenticate) 


mux.HandleFunc("/thread/new", newThread) 
mux.HandleFunc("/thread/create", createThread) 
mux.HandleFunc("/thread/post", postThread) 
mux.HandleFunc("/thread/read", readThread) 


server := &http.Server{ 
Addr: "@.0.0.0:8080", 
Handler: mux, 

} 


server.ListenAndServe() 


} 


PO 


main 函数 中 使 用 的 这 些 处 理 器 函数 并 没有 在 main.go 文件 中 定 
义 ， 它 们 的 定义 在 其 他 文件 里 面 ， 具体 请 参考 ChitChat 项 目的 完整 源 
US 


为 了 在 一 个 文件 里 面 引 用 另 一 个 文件 中 定义 的 函数 ， 诸 如 PHP、 
Ruby 和 Python 这 样 的 语言 要 求 用 户 编写 代码 去 包含 (include) 被 引用 水 
数 所 在 的 文件 ， 而 另 一 些 语言 则 要 求 用 户 在 编译 程序 时 使 用 特殊 的 链接 
Clink) 命令 。 





但 是 对 Go 语言 来 说 ， 用 户 只 需要 把 位 于 相同 目录 下 的 所 有 文件 都 
设置 成 同一 个 包 ， 那 么 这 些 文 件 就 会 与 包 中 的 其 他 文件 分 享 彼此 的 定 
义 。 又 或 者 ， 用 户 也 可 以 把 文件 放 到 其 他 独立 的 包 里 面 ， 然 后 通过 导入 

(import) 这些 包 来 使 用 它们 。 比 如 ，ChitChat 论 坛 就 把 连接 数据 库 的 
代码 放 到 了 独立 的 包 里 面 ， 我 们 很 快 就 会 看 到 这 一 点 。 








2.4.4 ”使 用 cookie 进 行 访问 控制 


跟 其 他 很 多 Web 应 用 一 样 ，ChitChat 既 拥有 任何 人 都 可 以 访问 的 公 
开 页 面 ， 也 拥有 用 户 在 登录 账号 之 后 才能 看 见 的 私人 页 面 。 





当 一 个 用 户 成 功 登 录 以 后 ， 服 务 器 必须 在 后 续 的 请 求 中 标示 出 这 是 
一 个 已 登录 的 用 户 。 为 了 做 到 这 一 点 ， 服 务 器 会 在 响应 的 首部 中 
个 cookie， 而 客户 端 在 接收 这 个 cookie 之 后 则 会 把 它 存储 到 浏览 器 
面 。 代 码 清单 2-4 展 示 了 authenticate 处 理 器 函数 的 实现 代码 ， 这 个 
数 定义 在 route_auth.go 文件 中 ， 它 的 作用 就 是 对 用 户 的 号 份 a 
WE, FRESE TAZ a Tal Pig 1 [5] —“S cookie. 



































代码 清单 2-4 route_auth.go 文件 中 的 authenticate 处 理 器 函数 


func authenticate(w http.ResponsewWriter, r *http.Request) { 
r.ParseForm() 
user, _ := data.UserByEmail(r.PostFormValue("email") ) 
if user.Password == data.Encrypt(r.PostFormValue("password")) { 
session := user.CreateSession() 
cookie := http.Cookief{ 
Name: " cookie", 
Value: session.Uuid, 
HttpOnly: true, 


http.SetCookie(w, &cookie) 
http.Redirect(w, r, "/", 302) 
} else { 
http.Redirect(w, r, "/login", 302) 
} 
} 





注意 ， 代 码 清单 2-4 中 的 authenticate 函数 使 用 了 两 个 我 们 尚未 介 
绍 过 的 函数 ， 一 个 是 data.Encrypt ， 而 另 一 个 则 
是 data.UserbyEmail 。 因 为 本 市 关注 的 是 ChitChat 论 坛 的 访问 控制 机 
制 而 不 是 数据 处 理 方法 ， 所 以 本 节 将 不 会 对 这 两 个 函数 的 实现 细节 进行 
解释 ， 但 这 两 个 函数 的 名 字 已 经 很 好 地 说 明了 它们 各 自 的 作 
用 : data.UserByEmail 函数 通过 给 定 的 电子 邮件 地 址 获取 与 之 对 应 的 
User 结构 ， 而 data.Encrypt ae 定 的 字符 串 。 本 章 稍 
后 将 会 对 data 包 作 更 详细 的 介绍 ， 但 是 在 此 之 前 ， 让 我 们 回 到 对 访问 
控制 机 制 的 讨论 上 来 。 

















在 验证 用 户 映 份 的 时 候 ， 程 序 必须 先 确 保 用 户 是 真实 存在 的 ， 并 且 
提交 给 处 理 絮 的 密码 在 加 密 之 后 跟 存储 在 数据 库 里 面 的 已 加 密 用 户 密码 
完全 一 致 。 在 核实 了 用 户 的 身份 之 后 ， 程 序 会 使 用 User 结构 的 








CreateSession 方法 创建 一 个 session 结构 ， 该 结构 的 定义 如 下 : 


type Session struct { 
int 
string 


CreatedAt time.Time 


} 





Session 结构 中 的 Email 字段 用 于 存储 用 户 的 电子 邮件 地 址 ， 
而 UserId 字段 则 用 于 记录 用 户 表 中 存储 用 户 信息 的 行 的 DD。Uuid 字段 
存储 的 是 一 个 随机 生成 的 唯一 ID， 这 个 ID 是 实现 会 话机 制 的 核心 ， 服 务 
器 会 通过 cookie 把 这 个 ID 存储 到 浏览 器 里 面 ， 并 把 session 结构 中 记录 
的 各 项 信息 存储 到 数据 库 中 。 








在 创建 了 session 结构 之 后 ， 程 序 又 创建 了 Cookie 结构 : 


cookie := http.Cookie{ 
Name: "cookie", 
Value: session.Uuid, 


HttpOnly: true, 











cookie 的 名 字 是 随意 设置 的 ， 而 cookie 的 值 则 是 将 要 被 存储 到 浏览 
器 里 面 的 唯一 ID。 因 为 程序 没有 给 cookie 设 置 过 期 时 间 ， 所 以 这 个 
cookie 束 成 了 一 个 会 话 cookie， 它 将 在 浏览 器 关闭 时 上 自动 被 移 除 。 此 
外 ， 程 序 将 HttpOnly 字段 的 值 设 置 成 了 true ， 这 意味 着 这 个 cookie 只 
能 通过 HTTP 或 者 HITPS 访 问 ， 但 是 却 无 法 通过 JavaScript 等 非 HITP API 
进行 访问 。 


在 设置 好 cookie 之 后 ， 程 序 使 用 以 下 这 行 代码 ， 将 它 添加 到 了 响应 
的 首部 里 面 : 


http.SetCookie(writer, &cookie) 


在 将 cookie 存 储 到 浏览 器 里 面 之 后 ， 程 序 接 下 来 要 做 的 就 是 在 处 理 
器 函数 里 面 检查 当前 访问 的 用 户 是 否 已 经 登录 。 为 此 ， 我 们 需要 创建 一 
个 名 为 session 的 工具 Cutility) 函数 ， 并 在 各 个 处 理 器 函数 里 面 复 用 
它 。 代 码 清单 2-5 展 示 了 session 函数 的 实现 代码 ， 跟 其 他 工具 函数 一 
样 ， 这 个 函数 也 是 在 util. go 文件 里 面 定义 的 。 再 提醒 一 下 ， 虽 然 程 序 
把 工具 函数 的 定义 都 放 在 了 util.go 文件 里 面 ， 但 是 因为 util.go 文件 
也 隶属 于 main 包 ， 所 以 这 个 文件 里 面 定义 的 所 有 工具 函数 都 可 以 直接 
在 整个 main 包 里 面 调用 ， 而 不 必 像 data.Encrypt 函数 那样 需要 先 引 
入 包 然 后 再 调用 。 



































代码 清单 2-5 util.go 文件 中 的 session 工具 函数 


func session(w http.ResponseWriter, r *http.Request)(sess data.Session, er 
r 
error){ 
cookie, err := r.Cookie("_cookie") 
if err == nil { 
sess = data.Session{Uuid: cookie.Value} 
if ok, := sess.Check(); !ok { 


err = errors.New("Invalid session") 
} 
} 


return 


} 








为 了 从 请 求 中 取出 cookie，session 函数 使 用 了 以 下 代码 : 


cookie, err := r.Cookie("_ cookie") 














如 果 cookie 不 存在 ， 那 么 esi ' 并 未 登录 ; 相反 ， 如 果 cookie 
和 存在， 那么 session 函数 将 继续 进行 第 二 项 检查 一 一 访问 数据 库 并 核实 
会 话 的 唯一 ID 是 否 存 在 。 pees eee Session 函数 完成 
的 ， 这 个 函数 会 从 cookie 中 取出 会 话 并 调用 后 者 的 Check 方法 : 





sess = data.Session{Uuid: cookie.Value} 
if ok, _ := sess.Check(); !ok { 
err = errors.New("Invalid session") 


} 











在 拥有 了 检查 和 识别 已 登录 用 户 和 未 登录 用 户 的 能 力 之 后 ， 让 我 们 
来 回顾 一 下 之 前 展示 的 index 处 理 器 函数 ， 代 码 清 单 2-6 中 被 加 粗 的 代 
人 码 行 展 示 了 这 个 处 理 器 函数 是 如 何 使 用 session 函数 的 。 





代码 清单 2-6”index 处 理 器 函数 





func index(w http.ResponseWriter, r *http.Request) { 
threads, err := data.Threads(); if err == nil { 
» err := session(w, r) 


public tmpl files := []string{"templates/layout.html", 
"templates/public.navbar.html", 
"templates/index.htm1"} 
private_tmpl_ files := []string{"templates/layout.html", 
"templates/private.navbar.html", 
"templates/index.htm1"} 
var templates *template. Template 


if err != nil { 
templates = template.Must (template. Parse- 
Files(private_tmpl_ files...)) 
} else { 
templates = template.Must(template.ParseFiles(public_tmpl files...)) 


} 
templates.ExecuteTemplate(w, "layout", threads) 
} 


} 





通过 调用 session 函数 可 以 取得 一 个 存储 了 用 户 信 息 的 Session 4 
构 ， 不 过 因为 index 函数 日 前 并 不 需要 这 些 信 息 ， 所 以 它 使 用 空白 标识 
符 (blank identifier) (_) 忽略 了 这 一 结构 。index 函数 真正 感 兴 趣 的 





zerr 变量 ， 程 序 会 根据 这 个 变量 的 值 来 判断 用 户 是 舍 已 经 登录 ， 然 后 
以 此 来 选择 是 使 用 public 导航 条 还 是 使 用 private 导航 条 。 

好 的 ， 关 于 ChitChat 应 用 处 理 请 求 的 方法 就 介绍 到 这 里 了 。 本 章 接 
下 来 会 继续 讨论 如 何 为 客户 端 生成 HIML， 并 完整 地 叙述 之 前 没有 说 完 


的 部 分 。 





2.5 ”使 用 模板 生成 HTML 啊 应 





index 处 理 器 函数 里 面 的 大 部 分 代码 都 是 用 来 为 客户 端 生成 HTML 
的 。 首 先 ， 函 数 把 每 个 需要 用 到 的 模板 文件 都 放 到 了 Go 切片 里 面 〈 这 
里 展示 的 是 私有 页 面 的 模板 文件 ， 公 开 页 面 的 模板 文件 也 是 以 同样 方式 
进行 组 织 的 ) : 





private tmpl files := []string{"templates/layout.html", 


"templates/private.navbar.html", 
"templates/index.htm1"} 





跟 Mustache 和 CTemplate 等 其 他 模板 引擎 一 样 ， 切 片 指定 的 这 3 个 
HTML 文 件 都 包含 了 特定 的 舱 入 命令 ， 这 些 命令 被 称 为 动作 
(action〉， 动 作 在 HTML 文 件 里 面 会 被 {{ 符号 和 }} 符号 包围 。 


接着 ， 程 序 会 调用 ParseFiles 函数 对 这 些 模板 文件 进行 语法 分 
析 ， 并 创建 出 相应 的 模板 。 为 了 捕捉 语法 分 析 过 程 中 可 能 会 产生 的 错 
误 ， 程 序 使 用 了 Must 函数 去 包围 ParseFiles 函数 的 执行 结果 ， 这 样 
当 ParseFiles 返回 错误 的 时 候 ，Must 函数 就 会 向 用 户 返 回 相应 的 错误 
报告 : 


templates := template.Must(template.ParseFiles(private_tmpl files...)) 





好 的 ， 关 于 模板 文件 的 介绍 已 经 足够 多 了 ， 现 在 是 时 候 来 看 看 它们 
的 庐山 真面目 了 。 





ChitChat 论 坛 的 每 个 模板 文件 都 定义 了 一 个 模板 ， 这 种 做 法 并 不 是 
强制 的 ， 用 户 也 可 以 在 一 个 模板 文件 里 面 定义 多 个 模板 ， 但 模板 文件 和 
模板 一 一 对 应 的 做 法 可 以 给 开发 带 来 方便 ， 我 们 在 之 后 就 会 看 到 这 一 
点 。 代 码 清单 2-7 展 示 了 1ayout .html 模板 文件 的 源 代码 ， 源 代码 中 使 
用 了 define 动作 ， 这 个 动作 通过 文件 开头 的 {{ define "layout" }} 
和 文件 末尾 的 {{ end }} ， 把 被 包围 的 文本 块 定义 成 了 layout 模板 的 


一 部 分 。 








代码 清单 2-7 ”layout.html 模板 文件 


{{ define "layout" }} 


<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=9"> 
<meta name="viewport" content="width=device-width, initial-scale=1"> 
<title>ChitChat</title> 
<link href="/static/css/bootstrap.min.css" rel="stylesheet"> 
<link href="/static/css/font-awesome.min.css" rel="stylesheet"> 
</head> 
<body> 
{{ template "navbar" . }} 


<div class="container"> 
{{ template "content" . }} 


</div> <!-- /container --> 


<script src="/static/js/jquery-2.1.1.min.js"></script> 
<script src="/static/js/bootstrap.min.js"></script> 
</body> 
</html> 


{{ end }} 





除了 define 动作 之 外 ，1layout .html 模板 文件 里 面 还 包含 了 两 个 
用 于 引用 其 他 模板 文件 的 template 动作 。 跟 在 被 引用 模板 名 字 之 后 的 
点 〈《. ) 代表 了 传递 给 被 引用 模板 的 数据 ， 比 如 {{ template 
"navbar" . }} 语句 除了 会 在 语句 出 现 的 位 置 引入 navbar 模板 之 外 ， 
还 会 将 传递 给 layout 模板 的 数据 传递 给 navbar 模板 。 





代码 清单 2-8 展 示 了 public.navbar.html 模板 文件 中 的 navbar 模 
板 ， 除 了 定义 模板 自身 的 define 动作 之 外 ， 这 个 模板 没有 包含 其 他 动 
作 “【〈 严 格 来 说 ， 模 板 也 可 以 不 包含 任何 动作 ) 。 




















代码 清单 2-8 public.navbar .html 模板 文件 














{{ define "navbar" }} 


<div class="navbar navbar-default navbar-static-top" role="navigation"> 
<div class="container"> 
<div class="navbar-header"> 
<button type="button" class="navbar-toggle collapsed" 
æ data-toggle="collapse" data-target=".navbar-collapse"> 
<span class="sr-only">Toggle navigation</span> 
<span class="icon-bar"></span> 
<span class="icon-bar"></span> 
<span class="icon-bar"></span> 
</button> 
<a class="navbar-brand" href="/"> 
<i class="fa fa-comments-o"></i> 
ChitChat 
</a> 
</div> 
<div class="navbar-collapse collapse"> 
<ul class="nav navbar-nav"> 
<li><a href="/">Home</a></1i> 
</ul> 
<ul class="nav navbar-nav navbar-right"> 
<li><a href="/login">Login</a></1li> 
</ul> 
</div> 
</div> 
</div> 


{{ end }} 


最 后 ， 让 我 们 来 看 看 定义 在 index.html 模板 文件 中 的 content 模 
板 ， 代 码 清单 2-9 展 示 了 这 个 模板 的 源 代 码 。 注 意 ， 尽 管 之 前 展示 的 两 
个 模板 都 与 模板 文件 拥有 相同 的 名 字 ， 但 实际 上 模板 和 模板 文件 分 别 拥 
有 不 同 的 名 字 也 是 可 行 的 。 











代码 清 














2-9 index.html 模板 文件 
{{ define "content" }} 
<p class="lead"> 


<a href="/thread/new">Start a thread</a> or join one below! 
</p> 


{{ range . }} 
<div class="panel panel-default"> 
<div class="panel-heading"> 


<span class="lead"> <i class="fa fa-comment-o"></i> {{ .Topic }}</sp 


an> 
</div> 
<div class="panel-body"> 


Started by {{ .User.Name }} - {{ .CreatedAtDate }} - {{ .NumReplies 
}} 


posts. 
<div class="pull-right"> 
<a href="/thread/read?id={{.Uuid }}">Read more</a> 
</div> 
</div> 
</div> 


{{ end }} 
{{ end }} 





index.html 文件 里 面 的 代码 非常 有 趣 ， 特 别 值得 一 提 的 是 文件 里 





面包 含 了 几 个 以 点 号 〈. ) 开头 的 动作 ， 比 如 {{ .User.Name }} Al{{ 
.CreatedAtDate }} ， 这 些 动作 的 作用 和 之 前 展示 过 的 index bei as 
函数 有 关 : 


threads, err := data.Threads(); if err == nil { 
templates.ExecuteTemplate(writer, "layout", threads) 


} 





在 以 下 这 行 代码 中 : 


templates.ExecuteTemplate(writer, "layout", threads) 


程序 通过 调用 ExecuteTemplate ia, HUT (execute) 已 经 经 过 

语法 分 析 的 layout 模板 。 执 行 模板 意味 着 把 模板 文件 中 的 内 容 和 来 自 

其 他 渠道 的 数据 进行 合并 ， 然 后 生成 最 终 的 HIML 内 容 ， 有 具体 过 程 如 图 
2-6 所 示 。 








模板 


图 2-6 模板 引擎 通过 合并 数据 和 模板 来 生成 HTML 





程序 之 所 以 对 layout 模板 而 不 是 navbar 模板 或 者 content 模板 进 
行 处 理 ， 是 因为 layout 模板 已 经 引用 了 其 他 两 个 模板 ， 所 以 执 
行 1ayout 模板 就 会 导致 其 他 两 个 模板 也 被 执行 ， 由 此 产生 出 预期 的 
HTML。 但 是 ， 如 果 程 序 只 执行 havbar 模板 或 者 content 模板 ， 那 么 


程序 最 终 只 会 产生 出 预期 的 HTML 的 一 部 分 。 
现在 ， 你 应 该 已 经 明白 了 ， 点 号 〈. ) 代表 的 就 是 传 入 到 模板 里 面 
的 数据 《实际 上 还 不 仅 如 此 ， 接 下 来 的 小 节 会 对 这 方面 做 进一步 的 说 


HY) 。 图 2-7 展 示 了 程序 根据 模板 生成 的 ChitChat 论 坛 的 样子 。 











localhost 


eco < 


Œ ChitChat 
© How long does it take to write a book? 
Read more 


© What does it take to write a forum application? 


图 2-7 ChitChat Web 应 用 示例 的 主页 


整理 代码 


因为 生成 HTML 的 代码 会 被 重 复 执 行 很 多 次 ， 所 以 我 们 决定 对 这 些 
代码 进行 一 些 整 理 ， 并 将 它们 移 到 代码 清单 2-10 所 示 的 generateHTML 
PKI Zir E H o 

















代码 清单 2-10 generateHTML 函数 








func generateHTML(w http.ResponseWriter, data interface{}, fn ...string) { 
var files []string 
for _, file := range fn { 
files = append(files, fmt.Sprintf("templates/%s.html", file)) 
} 


templates := template.Must(template.ParseFiles(files...)) 
templates.ExecuteTemplate(writer, "layout", data) 


} 





generateHTML 函数 接受 一 个 ResponseNriter 、 一 些 数据 以 及 一 
系列 模板 文件 作为 参数 ， 然 后 对 给 定 的 模板 文件 进行 语法 分 析 。data 
参数 的 类 型 为 空 接口 类 型 (empty interface type) ， 这 意味 着 该 参数 可 
以 接受 任何 类 型 的 值 作为 输入 。 刚 开始 接触 Go 语言 的 人 可 能 会 觉得 奇 





怪 一 一 Go 不 是 静态 编程 语言 吗 ， 它 为 什么 能 够 使 用 没有 类 型 限制 的 参 
数 ? 


但 实际 上 ，Go 程 序 可 以 通过 接口 〈interface) 机 制 ， 巧 妙 地 绕 过 静 
态 编程 语言 的 限制 ， 并 籍 此 获得 接受 多 种 不 同类 型 输入 的 能 力 。Go 语 
言 中 的 接口 由 一 系列 方法 构成 ， 并 且 每 个 接口 就 是 一 种 类 型 。 一 个 空 接 
口 就 是 一 个 空 集合 ， 这 意味 痢 任 何 类 型 都 可 以 成 为 一 个 空 接口 ， 也 就 是 
说 任何 类 型 的 值 都 可 以 传递 给 函数 作为 参数 。 





generateHTML 函数 的 最 后 一 个 参数 以 3 个 点 〈... ) 开头 ， 它 表 


示 generateHTML 函数 是 一 个 可 变 参 数 函 数 (variadic function) , KER 
味 着 这 个 函数 可 以 在 最 后 的 可 变 参 数 中 接受 零 个 或 任意 多 个 值 作为 参 
数 。generateHTML 函数 对 可 变 参数 的 文 持 使 我 们 可 以 同时 将 任意 多 个 
模板 文件 传递 给 该 函数 。 在 Go 语言 里 面 ， 可 变 参 数 必须 是 可 变 参数 函 
数 的 最 后 一 个 参数 。 





在 实现 了 generateHTML 函数 之 后 ， 让 我 们 回 过 头 来 ， 继 续 对 
index 处 理 器 函数 进行 整理 。 代 码 清单 2-11 展 示 了 经 过 整理 之 后 的 
index 处 理 器 函数 ， 现 在 它 看 上 去 更 整洁 了 。 




















代码 清单 2-11 index 处 理 器 函数 的 最 终 版 本 




















func index(writer http.ResponseWriter, request *http.Request) { 
threads, err := data.Threads(); if err == nil { 
_, err := session(writer, request) 
if err != nil { 
generateHTML(writer, threads, "layout", “public.navbar", "index") 
} else { 


generateHTML(writer, threads, "layout", "“private.navbar", "index") 





在 这 一 节 中 ， 我 们 学 习 了 很 多 关于 模板 的 基础 知识 ， 之 后 的 第 5 章 
将 对 模板 做 更 详细 的 介绍 。 但 是 在 此 之 前 ， 让 我 们 先 来 了 解 一 下 
ChitChat 应 用 使 用 的 数据 源 (data source) ， 并 和 糊 此 了 解 一 下 ChitChat 心 
用 的 数据 是 如 何 与 模板 一 同 生 成 最 终 的 HTML 的 。 





2.6 ”安装 PostgreSQL 


在 本 章 以 及 后 续 几 章 中 ， 每 当 遇 到 需要 访问 关系 数据 库 的 场景 ， 我 
们 都 会 使 用 PostgreSQL 。 在 开始 使 用 PostgreSQL 之 前 ， 我 们 首先 需要 学 
习 的 是 如 何 安装 并 运行 PostgreSQL， 以 及 如 何 创建 本 章 所 需 的 数据 库 。 


2.6.1 在 Linux 或 FreeBSD 系 统 上 安装 


www.postgresql.org/download 为 各 种 不 同 版 本 的 Linux 和 FreeBSD 都 
提供 了 预 编译 的 二 进 制 安装 包 ， 用 户 只 需要 下 载 其 中 一 个 安装 包 ， 然 后 
根据 指示 进行 安装 就 可 以 了 。 比 如 说 ， 通 过 执行 以 下 命令 ， 我 们 可 以 在 
Ubuntu 发 行 版 上 安装 Postgres: 


sudo apt-get install postgresql postgresql-contrib 


这 条 命令 除了 会 安装 postgres 包 之 外 ， 还 会 安装 附加 的 工具 包 ， 
并 在 安装 完毕 之 后 启动 PostgreSQL 数 据 库 系 统 。 





在 默认 情况 下 ，Postgres 会 创建 一 个 名 为 postgres 的 用 户 ， 并 将 其 
用 于 连接 服务 器 。 为 了 操作 方便 ， 你 也 可 以 使 用 上 自己 的 名 字 创 建 一 个 
Postgres 账 号 。 要 做 到 这 一 点 ， 首 先 需 要 登入 Postgres 账 号 : 


sudo su postgres 


接着 使 用 createuser 命令 创建 一 个 PostgreSQL 账 号 : 


createuser -interactive 


最 后 ， 还 需要 使 用 createdb 命令 创建 以 你 的 账号 名 字 命 名 的 数据 


createdb <YOUR ACCOUNT NAME> 


2.6.2 ”在 Mac OS X 系 统 上 安装 


要 在 Mac OS X 上 安装 PostgreSQL ， 最 简单 的 方法 是 使 用 
PostgresApp.com 提 供 的 Postgres 应 用 : 你 只 需要 把 网 站 上 提供 的 zip 压 缩 
包 下 载 下 来 ， 解 压 它 ， 然 后 把 Postgres .app 文件 拖 忠 到 自己 的 
Applications 文件 夹 里 面 就 可 以 了 。 启 动 Postgres .app 的 方法 跟 启 
动 其 他 Mac OS X 应 用 的 方法 完全 一 样 。Postgres .app 在 初次 启动 的 时 
候 会 初始 化 一 个 新 的 数据 库 集群 ， 并 为 自己 创建 一 个 数据 库 。 因 为 命令 
行 工 具 psql 也 包含 在 了 Postgres.app 里 面 ， 所 以 在 设置 好 正确 的 路 
径 之 后 ， 你 就 可 以 使 用 psql 访问 数据 库 了 。 设 置 路 径 的 工作 可 以 通过 
在 你 的 ~/ .profile 文件 或 者 ~/ .bashrc 文件 中 添加 以 下 代码 行 来 完成 
(Hs 


export PATH=$PATH: /Applications/Postgres.app/Contents/Versions/9.4/bin 


2.6.3 在 Windows 系 统 上 安装 


因为 Windows 系 统 上 的 很 多 PostgreSQL 图 形 安装 程序 都 会 把 一 切 安 





装 步 又 布置 受 当 ， 用 户 只 需要 进行 相应 的 设置 就 可 以 了 ， 所 以 在 
Windows 系 统 上 安装 PostgreSQL 也 是 非常 简单 和 直观 的 。 其 中 一 个 流行 
的 安装 程序 是 由 Enterprise DB 提供 的 : www.enterprisedb.com/products- 


services-training/pgdownload. 


除了 PostgreSQL 数 据 库 本 身 之 外 ， 安 装 包 还 会 附带 诸如 pgAdmin 等 
工具 ， 以 便 用 户 通 过 这 些 工 具 进 行 后 续 的 配置 。 


2.7 ”连接 数据 库 








本 章 前 面 在 展示 ChitChat 应 用 的 设计 方案 时 ， 曾 经 提 到 过 ChitChat 
应 用 包含 了 4 种 数据 结构 。 虽 然 把 这 4 种 数据 结构 放 到 主 源码 文件 里 面 也 
是 可 以 的 ， 但 更 好 的 办 法 是 把 所 有 与 数据 相关 的 代码 都 放 到 另 一 个 包 里 
面 一 一 ChitChat 应 用 的 data 包 也 因此 应 运 而 生 。 





为 了 创建 data 包 ， 我 们 首先 需要 创建 一 个 名 为 data 的 子 目 录 ， 并 
创建 一 个 用 于 保存 所 有 帖子 相关 代码 的 thread.go 文件 (在 之 后 的 小 节 
里 面 ， 我 们 还 会 创建 一 个 用 于 保存 所 有 用 户 相 关 代 码 的 user .go 文 
件 ) 。 在 此 之 后 ， 每 当 程序 需要 用 到 data 包 的 时 候 〈 比 如 处 理 器 需要 
访问 数据 库 的 时 候 ) ， 程 序 都 需要 通过 import 语句 导入 这 个 包 : 








import ( 
"github. com/sausheong/gwp/Chapter_2_Go_ChitChat/chitchat/data" 


) 





代码 清单 2-12 展 示 了 定义 在 thread.go 文件 里 面 的 Thread 结构 ， 
这 个 结构 存储 了 与 帖子 有 关 的 各 种 信息 




















代码 清单 2-12 ”定义 在 thread.go 文件 里 面 的 Thread 结构 





package data 


import( 
"time" 


) 
type Thread struct { 
Id 


Uuid string 
Topic string 
UserId int 
CreatedAt time.Time 





正如 代码 清单 2-12 中 加 粗 显 示 的 代码 行 所 示 ， 文 件 的 包 名 现在 





是 data 而 不 再 是 main 了 ， 这 个 包 就 是 前 面 小 节 中 我 们 曾经 见 到 过 的 

data &. data 包 除 了 包含 与 数据 库 交 互 的 结构 和 代码 ， 还 包含 了 一 些 
与 数据 处 理 密切 相关 的 函数 。 隶 属于 其 他 包 的 程序 在 引用 data 包 中 定 
义 的 函数 、 结 构 或 者 其 他 东西 时 ， 必 须 在 被 引用 元 素 的 名 字 前 面 显 式 地 
加 上 data 这 个 包 名 。 比 如 说 ， 引 用 Thread 结构 就 需要 使 

用 data.Thread 这 个 名 字 ， 而 不 能 仅仅 使 用 Thread 这 个 名 字 。 








Thread 结构 应 该 与 创建 关系 数据 库 表 threads 时 使 用 的 数据 定义 
语言 (Data Definition Language, DDL ) 保持 一 致 。 因 为 threads #H 
前 尚未 存在 ， 所 以 我 们 必须 创建 这 个 表 以 及 容纳 该 表 的 数据 库 。 创 建 
chitchat 数据 库 的 工作 可 以 通过 执行 以 下 命令 来 完成 : 


createdb chitchat 


在 创建 数据 库 之 后 ， 我 们 就 可 以 通过 代码 清单 2-13 展 示 的 
setup. sql 文件 为 ChitChat 论 坛 创 建 相 应 的 数据 库 表 了 。 














代码 清单 2-13 ”用 于 在 PostgreSQL 里 面 创 建 数据 库 表 的 setup .sql 文件 




















create table users ( 
id serial primary key, 
uuid varchar(64) not null unique, 
name varchar(255), 
email varchar(255) not null unique, 
password varchar(255) not null, 
created at timestamp not null 


) ; 


create table sessions ( 
id serial primary key, 
uuid varchar(64) not null unique, 
email varchar(255), 
user_id integer references users(id), 
created at timestamp not null 


) ; 


create table threads ( 
id serial primary key, 
uuid varchar(64) not null unique, 
topic text, 
user_id integer references users(id), 
created at timestamp not null 


)3 


create table posts ( 
id serial primary key, 
uuid varchar(64) not null unique, 
body text, 
user_id integer references users(id), 
thread_id integer references threads(id), 
created at timestamp not null 





iy 


运行 这 个 脚本 需要 用 到 psql 工具 ， 正 如 上 一 市 所 说 ， 这 个 工具 通 
向 会 随 独 PostgreSQL 一 同安 装 ， 所 以 你 只 需要 在 终端 里 面 执行 以 下 命令 
LAT UA T: 


psql -f setup.sql -d chitchat 





如 果 一 切 正 常 ， 那 么 以 上 命令 将 在 chitchat 数据 库 中 创建 出 相应 
的 表 。 在 拥有 了 表 之 后 ， 程 序 就 必须 考虑 如 何 与 数据 库 进行 连接 以 及 如 
何 对 表 进 行 操作 了 。 为 此 ， 程 序 创建 了 一 个 名 为 Db 的 全 局 变量 ， 这 个 
全 局 变量 是 一 个 指针 ， 指 加 的 是 代表 数据 库 连 接 池 的 sq1.DB ， 而 后 续 
的 代码 则 会 使 用 这 个 Db 变量 来 执行 数据 库 碍 询 操作 。 代 码 清单 2-14 展 示 
J Db 变量 在 data.go 文件 中 的 定义 ， 此 外 还 展示 了 一 个 用 于 在 Web 应 
用 局 动 时 对 Db 变量 进行 初始 化 的 init 函数 。 





























代码 清单 2-14 data.go 文件 中 的 Db 全 局 变量 以 及 init 函数 











Var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "dbname=chitchat sslmode=disable" ) 


if err != nil { 
log.Fatal(err) 


return 


} 








现在 程序 已 经 拥有 了 结构 、 表 以 及 一 个 指向 数据 库 连 接 池 的 指针 ， 
接 下 来 要 考虑 的 是 如 何 连接 (connect) Thread 结构 和 threads K. 32 
运 的 是 ， 要 做 到 这 一 点 并 不 困难 : 跟 ChitChat 应 用 的 其 他 部 分 一 样 ， 我 
们 只 需要 创建 能 够 在 结构 和 数据 库 之 间 互 动 的 函数 就 可 以 了 。 例 如 ， 为 
了 从 数据 库 里 面 取 出 所 有 帖子 并 将 其 返回 给 jndex 处 理 器 函数 ， 我 们 可 
以 使 用 thread.go 文件 中 定义 的 Threads 函数 ， 代 码 清单 2-15 给 出 了 这 
个 函数 的 定义 。 











代码 清单 2-15 threads .go 文件 中 定义 的 Threads 函数 





func Threads() (threads []Thread, err error){ 
rows, err := Db.Query("SELECT id, uuid, topic, user_id, created_at FROM 
threads ORDER BY created_at DESC") 
if err != nil { 
return 
} 
for rows.Next() { 
th := Thread{} 
if err = rows.Scan(&th.Id, &th.Uuid, &th.Topic, &th.UserId, 
™»&th.CreatedAt); err != nil { 
return 
} 
threads = append(threads, th) 


rows.Close() 
return 


} 





简单 来 讲 ，Threads 函数 执行 了 以 下 工作 : 


(1) 通过 数据 库 连 接 池 与 数据 库 进 行 连接 ; 


(2) 向 数据 库 发 送 一 个 SQL 查 询 ， 这 个 查询 将 返回 一 个 或 多 个 行 
作为 结 


(3) 遍历 行 ， 为 每 个 行 分 别 创建 一 个 Thread 结构 ， 首 先 使 用 这 个 
结构 去 存储 行 中 记录 的 帖子 数据 ， 然 后 将 存储 了 帖子 数据 的 Thread 4 
构 追 加 到 传 入 的 threads WH EM; 





(4) 重复 执行 步骤 3， 直 到 得 询 返 回 的 所 有 行 都 被 届 历 完毕 为 止 。 





本 书 的 第 6 章 将 对 数据 库 操作 的 细节 做 进一步 的 介绍 。 


在 了 解 了 如 何 将 数据 库 表 存 储 的 帖子 数据 提取 到 Thread 结构 里 面 


Za, RI PRES EY Ae BU ey CER he E Re aN Thread 结构 存储 
的 数据 了 。 在 代码 清单 2-9 中 展示 的 index.html 模 板 文 件 ， 有 这 样 一 段 代 
码 : 


{{ range . }} 


<div class="panel panel-default"> 
<div class="panel-heading"> 
<span class="lead"> <i class="fa fa-comment-o"></i> {{ .Topic }}</sp 


an> 
</div> 
<div class="panel-body"> 
Started by {{ .User.Name }} - {{ .CreatedAtDate }} - {{ .NumReplies 
}} 
posts. 
<div class="pull-right"> 
<a href="/thread/read?id={{.Uuid }}">Read more</a> 
</div> 
</div> 
</div> 


{{ end }} 





正如 之 前 所 说 ， 模 板 动作 中 的 点 号 ©.) 代表 传 入 模板 的 数据 ， 它 
们 会 和 模板 一 起 生成 最 终 的 结果 ， 而 {{ range . J} 中 的 . 号 代表 的 是 
程序 在 稍 早 之 前 通过 Threads 函数 取得 的 threads 变量 ， 也 就 是 一 个 
由 Thread 结构 组 成 的 切片 。 


range 动作 假设 传 入 的 数据 要 么 是 一 个 由 结构 组 成 的 切片 ， 要 么 是 
一 个 由 结构 组 成 的 数组 ， 这 个 动作 会 裔 历 传 入 的 每 个 结构 ， 而 用 户 则 可 
以 通过 字段 名 访问 结构 里 面 的 字段 ， 比 如 ， 动 作 {{ .Topic }} 访问 的 
是 Thread 结构 的 Topic 字段 。 注 意 ， 在 访问 字段 时 必须 在 字段 名 的 前 
面 加 上 点 号 ， 并 且 字 段 名 的 首 字 母 必 须 大 写 。 














用 户 除 可 以 在 字段 名 的 前 面 加 上 点 号 来 访问 结构 中 的 字段 以 外 ， 还 
可 以 通过 相同 的 方法 调用 一 种 名 为 方法 (method) 的 特殊 函数 。 比 
如 ， 在 上 面 展示 的 代码 中 ，{{ .User.Name }}、{{ 
.CreatedAtDate }} 和 {{ .NumReplies }} 这 些 动 作 的 作用 就 是 调用 
结构 中 的 同名 方法 ， 而 不 是 访问 结构 中 的 字段 。 








方法 是 隶属 于 特定 类 型 的 函数 ， 指 针 、 接 口 以 及 包括 结构 在 内 的 所 
有 有 具名 类 型 都 可 以 拥有 自己 的 方法 。 比 如 说 ， 通 过 将 函数 与 指 
向 Thread 结构 的 指针 进行 绑 定 ， 可 以 创建 出 一 个 针对 Thread 结构 的 方 
法 ， 而 传 入 方法 里 面 的 Thread 结构 则 称 为 接收 者 (receiver) : 方法 可 
以 访问 接收 者 ， 也 可 以 修改 接收 者 。 


作为 例子 ， 代 码 清单 2-16 展 示 了 NumReplies 方法 的 实现 代码 。 








代码 清单 2-16 thread. go 文件 中 的 NumReplies 方法 





func (thread *Thread) NumReplies() (count int) { 
rows, err := Db.Query("SELECT count(*) FROM posts where thread_id = $1", 
thread.Id) 
if err != nil { 
return 


for rows.Next() { 
if err = rows.Scan(&count); err != nil { 
return 


rows.Close() 
return 


} 





NumReplies 方法 首先 打开 一 个 指 疝 数据 库 的 连接 ， 接 看 通过 执行 





一 条 SQL 碍 询 来 取得 帖子 的 数量 ， 并 使 用 传 入 方法 里 面 的 count 参数 来 
记录 这 个 值 。 最 后 ，NumReplies 方法 返回 帖子 的 数量 作为 方法 的 执行 
结果 ， 而 模板 引擎 则 使 用 这 个 值 去 代 蔡 模板 文件 中 出 现 的 {{ 
.NumReplies }} 动作 。 
通过 为 User . Session. Thread 和 Post 这 4 种 数据 结构 创建 相应 
的 函数 和 方法 ，ChitChat 最 终 在 处 理 器 函数 和 数据 库 之 间 构 建 起 了 一 个 
数据 层 ， 以 此 来 避免 处 理 器 函数 直接 对 数据 库 进 行 访 问 ， 图 2-8 展 示 了 
这 个 数据 层 和 数据 库 以 及 处 理 器 函数 之 间 的 关系 。 虽 然 有 很 多 库 都 可 以 
达到 同样 的 效果 ， 但 杀 自 构建 数据 层 能 够 帮助 我 们 学 习 如 何 对 数据 库 进 
行 基本 的 访问 ， 并 厌 此 了 解 到 实现 这 种 访问 并 不 困难 ， 只 需要 用 到 一 些 








简单 直接 的 代码 ， 这 一 点 是 非常 有 益 的 。 





图 2-8 

















通过 结构 模型 连接 数据 库 和 处 理 器 





2.8 ”启动 服务 器 


在 本 章 的 最 后 ， 让 我 们 来 看 一 下 cae 用 是 如 何 局 动 服务 器 并 
将 多 路 复 用 吉 与 服务 器 进行 绑 定 的 。 执 行 这 一 工作 的 代码 是 在 main.go 
文件 里 面 定义 的 : 
server := &http.Server{ 


Addr: "@.0.0.0:8080", 
Handler: mux, 


server.ListenAndServe() 





这 上 段 代 人 码 非 党 简单 ， 它 所 做 的 就 是 创建 一 个 Server 结构 ， 然 后 在 
这 个 结构 上 调用 ListenAndServe 方法 ， 这 样 服务 器 就 能 够 启动 了 。 


现在 ， 我 们 可 以 通过 执行 以 下 命令 来 编译 并 运行 ChitChat 应 用 : 


go build 


这 个 命令 会 在 当前 目录 以 及 $GOPATH/bin 目录 中 创建 一 个 名 
为 chitchat 的 二 进 制 可 执行 文件 ， 它 就 是 ChitChat 应 用 的 服务 器 。 接 
着 ， 我 们 可 以 通过 执行 以 下 命令 来 启动 这 个 服务 器 


./ chitchat 


如 果 你 已 经 按照 之 前 所 说 的 方法 ， 在 数据 库 里 面 创 建 了 ChitChat 尽 











用 所 需 的 数据 库 表 ， 那 么 现在 你 只 需要 访问 http://localhost:8080/ 并 注册 
一 个 新 账号 ， 然 后 就 可 以 使 用 自己 的 账号 在 论坛 上 发 布 新 帖子 了 。 


2.9 Web 应 用 运作 流程 回顾 


在 本 章 的 各 节 中 ， 我 们 对 一 个 Go Web 应 用 的 不 同 组 成 部 分 进行 了 
初步 的 了 解 和 观察 。 图 2-9 对 整个 应 用 的 工作 流程 进行 了 介绍 ， 其 中 包 
括 ; 





(1) Be Psi Dy ARS as AIA TR 
(2) See A ae BRR, FRE EE Il BY IE A Ab as 


C3) ADHERA ta IEE TT Mb HE 





(4) 在 需要 访问 数据 库 的 情况 下 ， 处 理 需 会 使 用 一 个 或 多 个 数据 
结构 ， 这 些 数据 结构 都 是 根据 数据 库 中 的 数据 建 模 而 来 的 ; 

















O) 当 处 理 需 调用 与 数据 结构 有 关 的 函数 或 者 方法 时 ， 这 些 数 据 
结构 背后 的 模型 会 与 数据 库 进 行 连接 ， 并 执行 相应 的 操作 ; 


(6) 当 请 求 处 理 完毕 时 ， 处 理 絮 会 调用 模板 引擎 ， 有 了 时候 还 会 问 
模板 引擎 传递 一 些 通 过 模型 获取 到 的 数据 ; 


(7) 模板 引擎 会 对 模板 文件 进行 语法 分 析 并 创建 相应 的 模板 ， 而 
这 些 模板 义 会 与 处 理 需 传递 的 数据 一 起 合并 生成 最 终 的 HIML; 


(8) 生成 的 HTML 会 作为 啊 应 的 一 部 分 回 传 至 客户 端 。 





图 2-9 Web 应 用 工作 流程 概览 


主要 的 步骤 大 概 就 是 这 些 。 在 接 下 来 的 几 章 中 ， 我 们 会 更 加 深入 地 
学 习 这 一 工作 流程 ， 并 进一步 了 解 该 流程 涉及 的 各 个 组 件 。 


2.10 ”小结 


请 求 的 接收 和 处 理 是 所 有 Web 应 用 的 核心 。 

多 路 复 用 器 会 将 HTTP 请 求 重 定 回 到 正确 的 处 理 器 进行 处 理 ， 针 对 
静态 文件 的 请 求 也 是 如 此 。 

处 理 右 函数 是 一 种 接受 ResponseWriter 和 Requeest 指针 作为 参 : 
的 Go 函数 。 

cookie 可 以 用 作 一 种 访问 控制 机 制 。 

对 模板 文件 以 及 数据 进行 语法 分 析 会 产生 相应 的 HIML， 这 些 
HTML 会 被 用 作 返 回 给 浏览 器 的 啊 应 数据 。 

通过 使 用 sql 包 以 及 相应 的 SQL 语 句 ， 用 户 可 以 将 数据 持久 地 存储 
在 关系 数据 库 中 。 








[1] 在 安装 Postgres.app 时 ， 你 可 能 需要 根据 Postgres.app 的 版 本 对 
路 径 的 版 本 部 分 做 相应 的 修改 ， 比 如 ， 将 其 中 的 9.4 修改 为 9.5 或 
者 9.6 ， 诸 如 此 类 。 一 一 译 者 注 


PWI = “Web 应 用 的 基本 组 成 部 分 





所 有 Web 应 用 都 齐 循 一 个 简单 的 请 求 与 啊 应 编程 模型 ， 客 户 端 发 送 
的 每 个 请 求 都 会 接收 到 一 个 来 目 服务 器 的 啊 应 。 每 个 Web 应 用 都 会 包含 
几 个 基本 组 件 ， 其 中 路 由 器 负责 将 请 求 转 发 至 不 同 的 处 理 器 ， 处 理 器 负 
员 对 请 求 进行 处 理 ， 而 模板 引擎 则 会 根据 静态 文件 和 动态 数据 生成 返回 
给 客户 端的 数据 。 











在 接 下 来 的 第 3 章 到 第 6 音 ， 我 们 将 学 习 如 何在 Go 语言 里 面 使 用 路 
由 器 去 接收 HTTP 请 求 ， 如 何 使 用 处 理 器 去 处 理 请 求 ， 以 及 如 何 使 用 模 
板 引 擎 去 创建 啊 应 数据 。 因 为 大 部 分 Web 应 用 都 会 以 菏 种 方式 存储 数 
据 ， 所 以 我 们 还 会 学 习 如 何 使 用 Go 语言 对 数据 进行 持久 化 。 


第 3 草 ”接收 请 求 


本 章 主要 内 容 


。 Go 语言 的 net/http 标准 库 的 使 用 方法 

。 通过 net/http 库 提供 HTTP 服 务 的 方法 
。 关于 处 理 器 以 及 处 理 器 函数 的 更 详细 信息 
。 在 服务 右上 使 用 多 路 复 用 器 的 方法 


在 第 2 章 中 ， 我 们 看 到 了 一 个 简单 的 网 上 论坛 Web 应 用 是 由 什么 组 
件 构成 的 ， 也 了 解 到 了 这 些 组 件 是 如 何 组 织 成 一 个 Go Web 应 用 的 。 虽 
然 我 们 已 经 对 构成 Go Web 应 用 的 各 个 组 件 有 了 基本 的 了 解 ， 但 关于 这 
些 组 件 还 有 很 多 值得 深入 的 事情 。 在 接 下 来 的 儿童 里 ， 我 们 将 更 为 深入 
地 了 解 这 些 组 件 的 细 市 ， 并 详细 地 探讨 这 些 组 件 是 如 何 组 合 起 来 的 。 





本 章 和 下 一 草 将 对 Web 应 用 的 “大 脑 ”〈 也 就 是 负责 接收 和 处 理 客 户 
端 请 求 的 处 理 器 ) 进行 讨论 。 在 本 章 中 ， 我 们 将 要 学 习 的 是 如 何 使 用 
Go 语言 去 创建 一 个 Web 服务 器 ， 以 及 如 何 处 理 客 户 问 发 送 的 请 求 。 


3.1 ”Go 的 net/http 标 准 库 


在 进行 Web 应 用 开发 的 时 候 ， 使 用 成 熟 并 且 复 杂 的 Web 应 用 框架 通 
常会 使 开发 变 得 更 加 迅速 和 简便 ， 但 这 也 意味 着 开发 者 必须 接受 框架 自 
寻 的 一 套 约定 和 模式 。 虽 然 很 多 框架 都 认为 自己 提供 的 约定 和 模式 是 最 
佳 实践 (best practice) ， 但 是 如 果 开 发 者 没有 正确 地 理解 这 些 最 佳 实 
践 ， 那 么 对 最 佳 实践 的 应 用 就 可 能 会 发 展 为 货物 泉 拜 编程 (cargo cult 
programming) : 开发 者 如 果 不 了 解 这 些 约定 和 模式 的 有 用法， 就 可 能 会 
在 不 必要 甚至 有 害 的 情况 下 盲目 地 使 用 它们 。 





上 货物 崇拜 编程 








第 二 次 世界 大 战 期 间 ， 盟 军 为 了 对 战事 提供 支援 ， 在 太平 洋 的 多 个 岛屿 上 设立 了 空军 基 
地 ， 以 空投 的 方式 向 部 队 以 及 支援 部 队 的 岛 民 投 送 了 大 量 生 活用 品 以 及 军事 设备 ， 从 而 极 大 
地 改善 了 部 队 以 及 岛 民 的 生活 ， 岛 民 也 因此 第 一 次 看 到 了 人 工 生产 的 衣物 、 铅 尖 食 品 以 及 
他 物品 。 在 战争 结束 之 后 ， 这 些 空军 基地 便 被 废弃 了 ， 货 物 空投 上 自然 也 停止 了 。 此 时 ， 岛 民 
做 了 一 件 非 常 符 合 其 本 性 的 事情 一 一 他 们 把 自己 打扮 成 空 管 员 、 士 兵 以 及 水 手 ， 使 用 机 场 上 
的 指挥 棒 挥 舞 着 着 陆 信和 号， 进行 地 面 阅 兵 演习 ， 试 图 让 飞机 继续 空投 货物 ， 货 物 尝 拜 一 词 也 
因此 而 诞生 。 



































































































































尽管 货物 公 拜 程序 员 并 没有 像 铝 民 一 样 挥舞 指挥 棒 ， 但 他 们 却 大 量 地 复制 和 粘贴 从 
StackOverflow 这 类 网 站 上 找 来 的 代码 ， 这 些 代码 虽然 能 够 运行 ， 但 是 他 们 却 对 这 些 代码 的 工 
作 原 理 一 点 也 不 了 解 。 这 样 做 的 结果 是 ， 他 们 通常 无 法 扩展 和 修改 这 些 代码 。 与 此 类 似 ， 货 
物 深 拜 程序 员 通 常会 在 既 不 了 解 框 染 为 什么 使 用 特定 的 模式 或 约定 ， 也 不 知道 框架 做 了 何 和 
取舍 的 情况 下 ， 言 目地 使 用 Web 框 架 。 























































































































举 个 例子 来 说 ， 因 为 HTTP 是 一 种 无 连接 协议 Cconnection-less 
protocol) ， 通 过 这 种 协议 发 送 给 服务 器 的 请 求 对 服务 器 之 前 处 理 过 的 





请 求 一 无 所 知 ， 所 以 应 用 程序 才 会 以 cookie 的 方式 在 客户 端 实 现 数据 持 
久 化 ， 并 以 会 话 的 方式 在 服务 器 上 实现 数据 持久 化 ， 而 不 了 解 这 一 点 的 
人 是 很 难 理解 为 什么 要 在 不 同 连 接 之 间 使 用 cookie 和 会 话 实现 信息 持久 
化 的 。 为 了 降低 使 用 cookie 和 会 话 带 来 的 复杂 性 ，Web 应 用 框架 通常 都 
会 提供 一 个 统一 的 接口 uniform interface) ， 用 于 在 连接 之 间 实 现 持久 
化 。 这 样 做 的 结果 是 ， 很 多 新 手 程序 员 都 会 想当然 地 假设 在 连接 之 间 进 
行 持 和 久 化 唯一 要 做 的 就 是 使 用 框架 提供 的 接口 。 但 是 由 于 这 类 接口 通常 
都 是 根据 框架 自身 的 习惯 制定 的 ， 因 此 不 同 框架 提供 的 接口 可 能 会 有 所 
不 同 。 更 糟 料 的 是 ， 不 同 的 框架 可 能 会 提供 一 些 名 字 相 同 的 接口 ， 但 是 
这 些 同名 接口 之 间 的 实现 却 又 干 差 万 别 、 各 不 相同 ， 因 此 给 开发 者 带 来 
不 必要 的 困惑 。 通 过 这 个 例子 可 以 看 出 ， 使 用 框架 pens 
味 着 将 框架 与 应 用 进行 绑 定 ， 之 后 无 论 是 将 应 用 迁移 至 另 一 个 框架 ， 

是 对 应 用 进行 扩展 ， 又 或 者 为 应 用 添加 新 的 特性 ， 都 需要 对 框架 ee 
深入 的 了 解 ， 在 某 些 情况 下 可 能 还 需要 对 框架 进行 定制 。 











本 书 的 目的 并 不 是 让 大 家 抛弃 框架 、 约 定 和 模式 一 一 一 个 好 的 框架 
通常 是 快速 构建 可 扩展 且 健壮 的 Web 应 用 的 最 好 方法 ， 但 理解 那些 隐藏 
在 框架 之 下 的 底层 概念 和 基础 设施 也 是 非常 重要 的 。 只 要 对 框 染 的 实现 
原理 有 了 正确 的 认识 ， 我 们 就 可 以 更 加 清晰 地 了 解 到 这 些 约定 和 模式 是 
如 何 形成 的 ， 从 而 避免 陷阱 、 理 清 思 路 ， 不 再 盲目 地 使 用 模式 。 





对 Go 语言 来 说 ， 隐 藏 在 框架 之 下 的 通常 是 net/http be 
html/template 这 两 个 标准 库 ， 本 章 和 接 下 来 的 第 4 章 将 介 
net/http 库 ， 而 之 后 的 第 5 章 将 介绍 html/template Æ. 


如 图 3-1 所 示 ，net/http 标准 库 可 以 分 为 客户 端 和 服务 器 两 个 


Do EPRA RRA E R SC RE2S ait A R S a PSA Tt 
A ES PY Sc FSP Sieg BR a : 





e Client . Response , Header . Request 和 Cookie 对 客户 端 进 和 
文 持 ; 

e Server., ServeMux 、Handler/HandleFunc . ResponseWriter 
. Header . Request 和 Cookie 则 对 服务 器 进行 支持 。 


本 章 接 下 来 将 会 展示 如 何 把 net/http 标准 库 用 作 服 务 器 以 及 如 何 
使 用 Go 语言 接收 客户 端 发 送 的 HTTP 请 求 。 在 之 后 的 第 4 章 ， 我 们 还 会 
继续 使 用 net/http 标准 库 ， 但 焦点 会 放 在 如 何 处 理 请 求 上 面 。 


在 本 书 中 ， 我 们 主要 关注 的 是 如 何 使 用 net/http 标准 库 的 服务 器 
TARE MARS PF Hi TA BE o 
服务 器 


ResponseWriter 
Header 


Handler/HandlerFunc 


ServeMux 





图 3-1 net/http 标准 库 的 各 个 组 成 部 分 


3.2 (EH Got ERA am 


如 图 3-2 所 示 ， 通 过 net/http 标准 库 ， 我 们 可 以 启动 一 个 HTTP 服 
务 器 ， 然 后 让 这 个 服务 器 接收 请 求 并 回 请 求 返 回响 应 。 除 此 之 
外 ，net/http 标准 库 还 提供 了 一 个 连接 多 路 复 用 器 (multiplexer)〉 的 
接口 以 及 一 个 默认 的 多 路 复 用 器 。 














图 3-2 ”通过 Go 服务 器 处 理 请 求 








3.2.1 Go Web 服 务 器 


跟 其 他 编程 语言 里 面 的 绝 大 多 数 标准 库 不 一 样 ，Go 提 供 了 一 系列 
用 于 创建 Web 服 务 器 的 标准 库 。 正 如 代码 清单 3-1 所 示 ， 创 建 一 个 服务 
器 的 步骤 非常 简单 ， 只 要 调用 ListenAndserve 并 传 入 网 络 地 址 以 及 负 
责 处 理 请 求 的 处 理 器 Chandler) 作为 参数 就 可 以 了 。 如 果 网 络 地 址 参数 
为 空 字符 串 ， 那 么 服务 器 默认 使 用 80 端 口 进行 网 络 连接 ， 如 果 处 理 器 参 
数 为 nil ， 那 么 服务 器 将 使 用 默认 的 多 路 复 用 器 DefaultserveMux 。 
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package main 


import ( 
"net/http" 
) 


func main() { 
http.ListenAndServe("", nil) 
} 





用 户 除了 可 以 通过 ListenAndServe 的 参数 对 服务 器 的 网 络 地 址 和 
处 理 器 进行 配置 之 外 ， 还 可 以 通过 Server 结构 对 服务 器 进行 更 详细 的 
配置 ， 其 中 包括 为 请 求 读 取 操作 设置 超时 时 间 、 为 响应 写 入 操作 设置 超 
时 时 间 以 及 为 Server 结构 设置 错误 日 志 记 录 器 等 








| 的 作用 基本 上 是 相同 的 ， 它 们 之 间 的 唯 
一 区 别 在 于 代码 清单 3-2 可 以 通过 server 结构 对 服务 器 进行 更 多 的 配 
B 

















代码 清单 3-2 ”人 带 有 附加 配置 的 Web 服务 器 





package main 


import ( 
"net/http" 
) 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


Handler: nil, 


server.ListenAndServe() 


} 


Ct 
代码 清单 3-3 展 示 了 Server 结构 所 有 可 选 的 配置 选项 。 








代码 清单 3-3 Server 结构 的 配置 选项 





type Server struct { 
Addr string 
Handler Handler 
ReadTimeout time.Duration 
WriteTimeout time.Duration 
MaxHeaderBytes int 
TLSConfig *tls.Config 


TLSNextProto map[string]func(*Server, *tls.Conn, Handler) 
ConnState func(net.Conn, ConnState) 
ErrorLog *log.Logger 





3.2.2 ”通过 HTTPS 提 供 服务 


当 客 户 端 和 服务 器 需要 共享 密码 或 者 信用 卡 信 息 这 样 的 私密 信息 

时 ， 大 多 数 网 站 都 会 使 用 HTTPS 对 客户 端 和 服务 器 之 间 的 通信 进行 加 密 
和 保护 。 在 一 些 情况 下 ， 这 种 保护 甚至 是 强制 性 的 。 比 如 说 ， 如 果 一 个 
网 站 提供 了 信用 卡 文 付 功能 ， 那 么 按照 支付 卡 行业 数据 安全 标准 
(Payment Card Industry Data Security Standard) ， 这 个 网 站 就 必须 对 客 
户 症 和 服务 嚣 之 间 的 通信 进行 加 密 。 像 Gmail 和 Facebook 这 样 带 有 隐私 
性 质 的 网 站 甚至 在 整个 网 站 上 都 局 用 了 HTITPS。 如 采 你 打算 开发 一 个 网 
站 ， 而 这 个 网 站 又 需要 提供 用 户 登 录 功 能 ， 那 么 你 也 需要 在 这 个 网 站 上 
启用 HTTPS。 





HTTPS 实 际 上 就 是 将 HTTP 通 信 放 到 SSL 之 上 进行 。 通 过 使 
用 ListenAndServeTLS 函数 ， 我 们 可 以 让 之 前 展示 过 的 简单 Web 应 用 


也 提供 HTTPS 服 务 ， 代 码 清音 3-4 展 示 了 其 体 的 实现 代码 。 


代码 清单 3-4 通过 HTTPS 提 供 服务 





package main 


import ( 
"net/http" 
) 


func main() { 


server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: nil, 

} 


server.ListenAndServeTLS("cert.pem", "key.pem") 


} 





这 段 代 码 中 的 cert .pem 文件 是 SSL 证 书 ， 而 key.pem 则 是 服务 器 
的 私 钥 (private key) 。 在 生产 环境 中 使 用 的 SSL 证 书 需要 通过 
VeriSign、Thawte 或 者 Comodo SSL 这 样 的 CA 取得 ， 但 如 果 是 出 于 测试 
目的 才 使 用 证 书 和 私 钥 ， 那 么 使 用 自行 生成 的 证 书 就 可 以 了 。 生 成 证 书 
的 办 法 有 很 多 种 ， 其 中 一 种 就 是 使 用 Go 标准 库 中 的 crypto 包 群 
(library group) 。 








SSL (Secure Socket Layer， 安 全 套 接 字 层 ) 是 一 种 通过 公 钥 基础 设施 (Public Key 
Infrastructure，PKI) 为 通信 双方 提供 数据 加 密 和 和 里 份 验证 的 协议 ， 其 中 通信 的 双方 通常 是 
户 端 和 服务 器 。SSL 最 初 由 Netscape 公 司 开 发 ， 之 后 由 IETEF (Internet Engineering Task Force, 
互联 网 工程 任务 组 ) 接手 并 将 其 改名 为 TLS (Transport Layer Security， 传 输 层 安全 协议 ) 。 
HTTPS， 即 SSL 之 上 的 HITP， 实 际 上 就 是 在 SSL/TLS 连 接 的 上 层 进行 HTTP 通 信 。 




































































HTTPS 需 要 使 用 SSL/TLS 证 书 来 实现 数据 加 密 以 及 身份 验证 (本 书 使 用 SSL 证 书 这 一 名 


























称 ， 因 为 它 更 常用 ) 。SSL 证 书 存储 在 服务 器 之 上 ， 它 是 一 种 使 用 X.509 格 式 进行 格式 化 的 数 
据 ， 这 些 数据 包含 了 公 钥 以 及 其 他 一 些 相关 信息 。 为 了 保证 证 书 的 可 靠 性 ， 证 书 一 般 由 证 书 
ay BLE (Certificate Authority, CA) 签发 。 服 务 器 在 接收 到 客户 端 发 送 的 请 求 之 后 ， 会 将 证 
书 和 响应 一 并 返回 给 客户 端 ， 而 客户 端 在 确认 证 书 的 真实 性 之 后 ， 就 会 生成 一 个 随机 密 铀 
(random key) ， 并 使 用 证 书 中 的 公 钥 对 随机 密 钥 进行 加 密 ， 此 次 加 密 产 生 的 对 称 密 铀 

























































































(symmetric key) 就 是 客户 端 和 服务 器 在 进行 通信 时 ， 负 责 对 通信 实施 加 密 的 实际 密 铀 
Cactual key) 。 























虽然 我 们 不 会 在 生产 环境 中 使 用 自行 生成 的 证 书 和 私 铀 ， 但 了 解 
SSL 证 书 和 私 钥 的 生成 方法 ， 并 学 会 如 何在 开发 和 测试 的 过 程 中 使 用 证 
书 和 私 钥 ， 也 是 一 件 非 常 有 意义 的 事情 。 代 码 清单 3-5 展 示 了 生成 SSL 证 
书 以 及 服务 器 私 钥 的 具体 代码 。 




















代码 清单 3-5 ”生成 个 人 使 用 的 SSL 证 书 以 及 服务 器 私 钥 











package main 


import ( 
"crypto/rand" 
"crypto/rsa" 
"crypto/x509" 
"crypto/x509/pkix" 
"encoding/pem" 
"math/big" 
"net" 
"os" 
"time" 


) 


func main() { 
max := new(big.Int).Lsh(big.NewInt(1), 128) 
serialNumber, _ := rand.Int(rand.Reader, max) 
subject := pkix.Name{ 
Organization: []string{"Manning Publications Co."}, 
OrganizationalUnit: []string{"Books"}, 
CommonName: "Go Web Programming”, 


} 


template := x509.Certificate{ 


SerialNumber: serialNumber, 


Subject: subject, 

NotBefore: time.Now(), 

NotAfter: time.Now().Add(365 * 24 * time.Hour), 

KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSi 
gnature, 


ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, 
IPAddresses: []net.IP{net.ParseIP("127.0.0.1")}, 
} 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, 
™»&template, &pk.PublicKey, pk) 
certOut, _ := os.Create("cert.pem") 


pem.Encode(certOut, &pem.Block{Type: "CERTIFICATE", Bytes: derBytes}) 
certOut.Close() 


keyOut, _ := os.Create("key.pem") 

pem.Encode(keyOut, &pem.Block{Type: "RSA PRIVATE KEY", Bytes: 
=» x509.MarshalPKCS1PrivateKey (pk) }) 

keyOut.Close() 








生成 SSEL 证 书 和 密 钥 的 步骤 并 不 是 特别 复杂 。 因 为 SSL 证 书 实际 上 


就 是 一 个 将 扩展 密 钥 用 法 (extended key usage) 设置 成 了 服务 器 身份 验 
证 操作 的 X.509 证 书 ， 所 以 程序 在 生成 证 书 时 使 用 了 crypto/x589 标准 
库 。 此 外 ， 因 为 创建 证 书 需要 用 到 私 铀 ， 所 以 程序 在 使 用 私 钥 成 功 创建 
证 书 之 后 ， 会 将 私 钥 单独 保存 在 一 个 存放 服务 器 私 钥 的 文件 里 面 。 





让 我 们 来 仔细 分 析 一 下 代码 清单 3-5 中 的 主要 代码 吧 。 首 先 ， 程 序 
使 用 一 个 Certificate 结构 来 对 证 书 进行 配置 : 





template := x509.Certificate{ 
SerialNumber: serialNumber, 
Subject: subject, 
NotBefore: time.Now(), 
NotAfter: time.Now().Add(365*24*time.Hour), 


KeyUsage: x509.KeyUsageKeyEncipherment | x509.KeyUsageDigitalSignature, 
ExtKeyUsage: []x509.ExtKeyUsage{x509.ExtKeyUsageServerAuth}, 
IPAddresses: []net.IP{net.ParseIP("127.0.0.1")}, 

} 








结构 中 的 证 书 序 列 号 (SerialNumber ) 用 于 记录 由 CA 分 发 的 唯 


一 号 码 ， 为 了 能 让 我 们 的 Web 应 用 运行 起 来 ， 程 序 在 这 里 生成 了 一 个 非 
党 长 的 随机 整数 来 作为 证 书 序列 号 。 之 后 ， 程 序 创建 了 一 个 专 有 名 称 
(distinguished name) ， 并 将 它 设置 成 了 证 书 的 标题 Csubject) 。 此 
外 ， 程 序 还 将 证 书 的 有 效 期 设置 成 了 一 年 ， 而 结构 中 KeyUsage 字段 和 
ExtKeyUsage 字段 的 值 则 表明 了 这 个 X.509 证 书 是 用 于 进行 服务 器 身份 
验证 操作 的 。 最 后 ， 程 序 将 证 书 设置 成 了 只 能 在 IP 地 址 127.0.0.1 之 上 运 
但。 




















X.509 是 国际 电信 联盟 电信 标准 化 部 门 〈ITU-T) 为 公 钥 基础 设施 制定 的 一 个 标准 ， 这 个 
标准 包含 了 公 钥 证 书 的 标准 格式 。 



































一 个 X.509 证 书 ( 简 称 SSL 证 书 ) 实际 上 就 是 一 个 经 过 编码 的 ASN.1 (Abstract Syntax 
Notation One， 抽 象 语法 表示 法 /1) 格式 的 电子 文档 。ASN.1 既 是 一 个 标准 ， 也 是 一 种 表示 
法 ， 它 描述 了 表示 电信 以 及 计算 机 网 络 数据 的 规则 和 结构 。 























X.509 证 书 可 以 使 用 多 种 格式 编码 ， 其 中 一 种 编码 格式 是 BER (Basic Encoding Rules， 基 
本 编码 规则 ) 。BER 格 式 指 定 了 一 种 自 解释 并 且 自 定义 的 格式 用 于 对 ASN.1 数 据 结构 进行 编 
码 ， 而 DER 格式 则 是 BER 的 一 个 子 集 。DER 只 提供 了 一 种 编码 ASN.1 值 的 方法 ， 这 种 方法 被 广 
泛 地 应 用 于 密码 学 当中 ， 尤 其 是 对 X.509 证 书 进行 加 密 。 







































































SSL 证 书 可 以 以 多 种 不 同 的 格式 保存 ， 其 中 一 种 是 PEM (Privacy Enhanced Email， 隐 私 增 
强 邮 件 ) 格式 ， 这 种 格式 会 对 DER 格式 的 X.509 证 书 实施 Base64 编 码 ， 并 且 这 种 格式 的 文件 都 
以 ----- BEGIN CERTIFICATE----- 开头 ， 以 ----- END CERTIFICATE----- 结尾 | 除了 
作文 件 格式 之 外 ，PEM 和 此 处 讨论 的 SSL 证 书 关系 并 不 大 ) 。 
























































在 此 之 后 ， 程 序 通 过 调用 crypto/rsa 标准 库 中 的 GeneratekKey K 
数 生成 了 一 个 RSA 私 钥 : 


pk, _ := rsa.GenerateKey(rand.Reader, 2048) 


程序 创建 的 RSA 私 钥 的 结构 里 面包 含 了 一 个 能 够 公开 访问 的 公 钥 
(public key〉， 这 个 公 钥 在 使 用 x589 .CreateCertificate 函数 创建 
SSL 证 书 的 时 候 就 会 用 到 : 


derBytes, _ := x509.CreateCertificate(rand.Reader, &template, &template, 
æ&pk.PublicKey, pk) 





CreateCertificate 函数 接受 Certificate 结构 、 公 钥 和 私 钥 等 
多 个 参数 ， 创 建 出 一 个 经 过 DER 编 码 格 式 化 的 字 节 切片 。 后 续 代 码 的 意 
图 也 非常 简单 明了 ， 它 们 首先 使 用 encoding/penm 标准 库 将 证 书 编码 
到 cert.pem 文件 里 面 : 


certOut, _ := os.Create("cert.pem") 


pem.Encode(certOut, &pem.Block{Type: "CERTIFICATE", Bytes: derBytes}) 
certOut.Close() 








然后 继续 以 PEM 编 码 的 方式 把 之 前 生成 的 密 钥 编码 并 保存 到 
key .pem 文 件 ŒM: 





keyOut, _ := os.Create("key.pem") 
pem.Encode(keyOut, &pem.Block{Type: "RSA PRIVATE KEY", Bytes: 
=» x509.MarshalPKCS1PrivateKey (pk) }) 


keyOut .Close() 


最 后 需要 提醒 的 是 ， 如 果 证 书 是 由 CA 签发 的 ， 那 么 证 书 文件 中 将 
同时 包含 服务 器 签名 以 及 CA 签名 ， 其 中 服务 器 签名 在 前 ，CA 签 名 在 
后 。 


3.3 ”处 理 器 和 处 理 器 函数 





在 前 面 的 内 容 中 ， 我 们 局 动 了 一 个 Web 服 务 器 ， 但 是 因为 这 个 服务 
器 疝 未 实现 任何 功能 ， 所 以 现在 访问 这 个 服务 器 只 会 获得 一 个 404 
HTTP 啊 应 代码 。 出 现 这 一 问题 的 原因 在 于 我 们 尚未 为 服务 器 编写 任何 
处 理 器 ， 所 以 服务 器 的 多 路 复 用 器 在 接收 到 请 求 之 后 找 不 到 任何 处 理 器 
来 处 理 请 求 ， 因 此 它 只 能 返回 一 个 404 响 应 。 为 了 让 服务 器 能 够 产生 实 
际 的 行为 ， 我 们 需要 为 之 编写 处 理 需 。 


3.3.1 处理 请 求 





前 面 的 第 1 章 和 第 2 章 曾 经 简单 地 介绍 过 处 理 器 以 及 处 理 器 函数 ， 现 
在 是 时 候 详 细 地 谈 谈 它 们 的 定义 了 。 在 Go 语言 中 ， 一 个 处 理 器 就 是 一 
个 拥有 ServeHTTP 方法 的 接口 ， 这 个 ServeHTTP 方法 需要 接受 两 个 参 
数 : 第 一 个 参数 是 一 个 ResponseWriter 接口 ， 而 第 二 个 参数 则 是 一 个 
指 加 Request 结构 的 指针 。 换 名 话说， 任何 接口 只 要 拥有 一 
个 ServeHTTP 方法 ， 并 且 该 方法 带 有 以 下 签名 (signature) , PAE 
Fe “PS Ab SE a 


ServeHTTP(http.ResponseWriter, *http.Request) 


现在 ， 让 我 们 暂时 离 题 一 下 ， 回 答 一 个 在 阅读 本 章 时 可 能 会 出 现在 
你 脑海 里 面 的 问题 : 既然 ListenAndSserve 接受 的 第 二 个 参数 是 一 个 处 
理 器 ， 那 么 为 何 它 的 默认 值 却 是 多 路 复 用 器 DefaultServeMux 呢 ? 











这 是 因为 DefaultServeMux 多 路 复 用 器 是 serveMux 结构 的 一 个 实 
例 ， 而 后 者 也 拥有 上 面 提 到 的 ServeHTTP 方法 ， 并 且 这 个 方法 的 签名 与 
成 为 处 理 器 所 需 的 签名 完全 一 致 。 换 句 话说 ，DefaultSserveMux Bt 
是 ServeMux 结构 的 实例 ， 也 是 Handler 结构 的 实例 ， 
此 DefaultServeMux 不 仅 是 一 个 多 路 复 用 器 ， 它 还 是 一 个 处 理 器 。 不 
过 DefaultServeMux 处 理 器 和 其 他 一 般 的 处 理 器 不 
同 ，DefaultServeMux 是 一 个 特殊 的 处 理 器 ， 它 唯一 要 做 的 就 是 根据 
请 求 的 URL 将 请 求 重 定向 到 不 同 的 处 理 器 。 在 了 解 了 这 些 知识 之 后 ， 我 
们 现在 只 需要 自行 编写 一 个 处 理 器 并 使 用 它 去 代替 默认 的 多 路 复 用 器 ， 
就 可 以 让 服务 器 正 第 地 对 客户 端 进行 啊 应 了 ， 有 基体 如 代码 清单 3-6 所 
7B o 



































代码 清单 3-6 “处理 请 求 

















package main 


import ( 
"fmt" 
"net/http" 


type MyHandler struct{} 


func (h *MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello World!") 
} 


func main() { 
handler := MyHandler{} 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: &handler, 


server.ListenAndServe() 


} 


[L CR 


现在 ， 只 要 按照 2.7 节 介绍 过 的 方法 启动 服务 器 ， 并 使 用 浏览 器 访 
问 地 址 http:/Wlocalhost:8080/， 我 们 就 可 以 在 浏览 器 里 面 看 到 Hello World 
响应 了 。 





有 趣 的 是 ， 如 果 我 们 使 用 浏览 器 访问 
http://localhost:8080/anything/at/all， 同 样 会 看 到 相同 的 Hello Worldi 
应 。 造 成 这 个 问题 的 原因 非常 明显 : 在 代码 清单 3-6 中 ， 程 序 创建 了 一 
个 处 理 器 并 将 它 与 服务 器 进行 了 绑 定 ， 以 此 来 代 蔡 原本 正在 使 用 的 默认 
多 路 复 用 峰 。 这 意味 着 服务 器 不 会 再 通过 URL 匹 配 来 将 请 求 路 由 至 不 同 
的 处 理 器 ， 而 是 直接 使 用 同一 个 处 理 右 来 处 理 所 有 请 求 ， 因 此 无 论 浏览 
器 访问 什么 地 址 ， 服 务 器 返回 的 都 是 同样 的 Hello World 啊 应 。 








这 也 是 我 们 在 Web 应 用 中 使 用 多 路 复 用 器 的 原因 : 对 某 些 特殊 用 途 
的 服务 器 来 说 ， 只 使 用 一 个 处 理 器 也 许 就 可 以 很 好 地 完成 工作 了 ， 但 是 
在 大 部 分 情况 下 ， 我 们 还 是 希望 服务 器 可 以 根据 不 同 的 URL 请 求 返 回 不 
同 的 啊 应 ， 而 不 是 一 成 不 变 地 只 返回 一 种 啊 应 。 


3.3.2 ”使 用 多 个 处 理 器 


在 大 部 分 情况 下 ， 我 们 并 不 希望 像 代码 清单 3-6 那 样 ， 使 用 一 个 处 
理 器 去 处 理 所 有 请 求 ， 而 是 希望 使 用 多 个 处 理 器 去 处 理 不 同 的 URL 
为 了 做 到 这 一 点 ， 我 们 不 再 在 Server 结构 的 Handler 字段 中 指定 处 理 
器 ， 而 是 让 服务 器 使 用 默认 的 DefaultSserveMux 作为 处 理 器 ， 然 后 通 
过 http.Handle 函数 将 处 理 器 绑 定 至 DefaultServeMux 。 需 要 注意 的 
是 ， 虽 然 Handle 函数 来 源 于 http 包 ， 但 它 实 际 上 是 ServeMux 结构 的 





方法 : 这 些 函 数 是 为 了 操作 便利 而 创建 的 函数 ， 调 用 它们 等 同 于 调 
用 DefaultServeMux 的 某 个 方法 。 比 如 说 ， 调 用 http.Handle 实际 上 
就 是 在 调用 DefaultServeMux 的 Handle 方法 。 


在 代码 清单 3-7 中 ， 程 序 创建 了 两 个 处 理 器 ， 并 将 它们 与 各 自 的 
URL 进 行 了 绑 定 。 现 在 ， 访 问 地 址 http://localhost:8080/hello 将 会 看 
到 “Hello!”， 而 访问 地 http://localhost:8080/world 则 会 看 到 “World!”。 
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代码 清单 3-7 使 用 多 个 处 理 器 对 请 求 进行 处 理 














package main 


import ( 
"fmt" 
"net/http" 
) 


type HelloHandler struct{} 


func (h *HelloHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 
{ 


} 


fmt.Fprintf(w, "Hello!") 


type WorldHandler struct{} 
func (h *WorldHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 


fmt.Fprintf(w, "World!") 


} 
func main() { 
hello := HelloHandler{} 
world := WorldHandler{} 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.Handle("/hello", &hello) 
http.Handle("/world", &world) 


server.ListenAndServe() 


} 





3.3.3 “处理 器 函数 


上 一 小 节 对 处 理 器 进行 了 介绍 ， 那 么 什么 | 数 呢 ? 处 理 器 
函数 实际 上 就 是 与 处 理 器 拥有 相同 行为 的 函数 : 这 些 函 数 与 ServeHTTP 
方法 拥有 相同 的 签名 ， 也 就 是 说 ， ea 和 指 
向 Request 结构 的 指针 作为 参数 。 代 码 清单 3-8 展 示 了 如 何在 服务 器 中 
使 用 处 理 器 函数 。 




















代码 清单 3-8 ”使 用 处 理 器 函数 处 理 请 求 


























package main 


import ( 
"fmt" 
"net/http" 
) 


func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 
} 


func world(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "World!") 
} 


func main() { 
server := http.Servert{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/hello", hello) 
http.HandleFunc("/world", world) 


server.ListenAndServe() 


Cd 
处 理 器 函数 的 实现 原理 是 这 样 的 : Go 语言 拥有 一 种 HandlerFunc 

函数 类 型 ， 它 可 以 把 一 个 带 有 正确 签名 的 函数 f 转换 成 一 个 带 有 方法 ff 

的 Handler 。 比 如 说 ， 对 下 面 这 个 hello 函数 来 说 : 





func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 


} 








程序 只 需要 执行 以 下 代码 : 


helloHandler := HandlerFunc(hello) 


就 可 以 把 helloHandler 设置 成 一 个 Handler 。 如 果 你 对 此 感到 疑惑 ， 
那么 不 妨 回 顾 一 下 之 前 展示 过 的 接受 处 理 器 的 服务 器 代码: 





package main 


import ( 
"fmt" 
"net/http" 
} 


type HelloHandler struct{} 


func (h*HelloHandler) ServeHTTP(w thhp.ResponseWriter, r *http.Request){ 
fmt.Fprintf(w, "Hello! ") 


} 
type WorldHandler struct{} 


func (h *WorldHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) 


{ 
fmt.Fprintf(w,"World!") 


} 


func main () { 
hello := HelloHandler{} 
world := WorldHandler{} 


server := thhp.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.Handle("/hello",&hello) 
http.Handle("/world", &world) 


server.ListenAndServe() 





这 个 程序 使 用 了 以 下 这 行 代码 来 绑 定 URL 地 址 /hello Mhello ph 


Bl: 


http.Handle("/hello", &hello) 


这 行 代码 向 我 们 展示 了 Handle 函数 将 一 个 处 理 器 绑 定 至 URL 的 具 
体 方法 。 此 外 ， 在 接受 处 理 器 函数 的 代码 清单 3-8 中 ，HandleFunc 函数 
会 将 hello 函数 转换 成 一 个 Handler ， 并 将 它 与 DefaultServeMux 进 
行 绑 定 ， 以 此 来 简化 创建 并 绑 定 Handler 的 工作 。 换 句 话 说 ， 处 理 器 函 
数 只 不 过 是 创建 处 理 器 的 一 种 便利 的 方法 而 已 。 代 码 清单 3-9 展 示 了 
http.HandleFunc 函数 的 具体 定义 。 








代码 清单 3-9 http.HandleFunc 函数 的 源 代码 














func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) { 
DefaultServeMux.HandleFunc(pattern, handler) 


} 





而 下 面 是 ServeMux.HandleFunc 方法 的 定义 : 


func (mux *ServeMux) HandleFunc(pattern string, handler func(ResponseWrite 
ry 
*Request)) { 
mux.Handle(pattern, HandlerFunc(handler) ) 


} 





注意 这 个 方法 是 如 何 使 用 HandlerFunc 函数 将 传 入 的 handler K 
数 转换 成 真正 的 处 理 器 的 。 


虽然 处 理 器 函数 能 够 完成 跟 处 理 占 一 样 的 工作 ， 并 且 使 用 处 理 莫 函 
数 的 代码 比 使 用 处 理 占 的 代码 更 为 整洁 ， 但 是 处 理 占 函数 并 不 能 完全 代 
丛 处 理 器 。 这 是 因为 在 菜 些 情况 下 ， 代 码 可 能 已 经 包含 了 东 个 接口 或 者 
菏 种 类 型 ， 这 时 我 们 只 需要 为 它们 添加 ServeHTTP 方法 就 可 以 将 它们 转 
变 为 处 理 器 了 ， 并 且 这 种 转变 也 有 助 于 构建 出 更 为 模块 化 的 web 应 用 。 


3.3.4 串联 多 个 处 理 器 和 处 理 器 函数 


尽管 Go 语言 并 不 是 一 门 函数 式 编程 语言 ， 但 它 也 拥有 一 些 函 数 式 
ig aes 如 函数 类 型 、 数 和 闭 包 。 正 如 前 面 的 代码 所 

， 在 Go 语言 里 面 ， 程 序 可 以 将 一 个 函数 传递 给 另 一 个 函数 ， 又 或 者 
me es Bo ane 程序 可 以 像 图 3-3 展 示 的 
那样 ， 将 函数 f1 传递 给 另 一 个 函数 f2 ， 然 后 在 函数 f2 执行 完 某 些 操作 
之 后 调用 f1 。 





输入 


执行 指定 的 操作 


f1 


输出 
执行 指定 的 操作 








图 3-3 ”串联 起 多 个 处 理 嚣 


来 看 一 个 完整 的 例子 : 假设 我 们 想 要 在 每 个 处 理 器 被 调用 时 ， 在 菏 
个 地 方 记 录 下 相应 的 调用 信息 。 为 此 ， 我 们 可 以 在 处 理 费 里 面 添加 一 些 
颌 外 的 代码 ， 又 或 者 像 第 2 章 那 样 ， 将 这 些 记录 代码 重 构 成 一 个 工具 函 
数 ， 然 后 让 每 个 处 理 器 都 去 调用 这 个 工具 函数 。 虽 然 实现 上 面 提 到 的 两 
种 方法 并 不 困难 ， 但 引入 额外 代码 的 做 法 会 给 程序 的 编写 带 来 及 虎 ， 并 
导致 处 理 需 需要 包含 与 处 理 请 求 无 天 的 代码 。 


诸如 日 志 记 录 、 安 全 检查 和 错误 处 理 这 样 的 操作 通常 被 称 为 横 切 关 
注 点 (cross-cutting concern) ， 昌 然 这 些 操 作 非 常常 见 ， 但 是 为 了 防止 
代码 重复 和 代码 依赖 问题 ， 我 们 又 不 希望 这 些 操 作 和 正常 的 代码 搅和 在 
一 起 。 为 此 ， 我 们 可 以 使 用 串联 〈chaining) 技术 分 隔 代 码 中 的 横 切 关 
注 点 。 代 码 清单 3-10 展 示 了 一 个 串联 多 个 处 理 器 的 例子 。 














代码 清单 3-10 ”串联 两 个 处 理 器 函数 


package main 





import ( 
WwW fmt WwW 
"net/http" 
"reflect" 
"runtime" 


) 


func hello(w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 
} 


func log(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.ResponseWriter, r *http.Request) { 
name := runtime.FuncForPC(reflect.ValueOf(h).Pointer()).Name() 


fmt.Println( "Handler function called - " + name) 
h(w, r) 
} 
} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.HandleFunc("/hello", log(hello)) 
server.ListenAndServe() 





PRADAS K Bhello 之 外 ， 这 个 代码 清单 还 包含 了 一 个 log K 
žl log 函数 接受 一 个 HandlerFunc 类 型 的 函数 作为 参数 ， 然 后 返回 另 
一 个 HandlerFunc 类 型 的 函数 作为 值 。 因 为 hello RAE 
个 HandlerFunc 类 型 的 函数 ， 所 以 代码 1og(hello) 实际 上 就 是 
将 hello 函数 发 送 至 1og 函数 之 内 ， 换 句 话 说， 这 段 代 码 串 联 起 了 1og 
函数 和 hello 函数 。 


log 函数 的 返回 值 是 一 个 匿名 函数 ， 因 为 这 个 匿名 函数 接受 一 
个 ResponseWriter 和 一 个 Request 指针 作为 参数 ， 所 以 它 实际 上 也 是 





一 个 HandlerFunc 。 在 匿名 函数 内 部 ， 程 序 首先 会 获取 被 传 入 的 
HandlerFunc 的 名 字 ， 然 后 再 调用 这 个 HandlerFunc 。 作 为 如 
果 我 们 使 用 浏览 器 访问 地 址 http://localhost:8080/hello， 那 么 浏览 器 页 面 
将 显示 以 下 信息 : 


Handler function called - main.hello 


WARRE ARIT DAB ee PS RAL, ABA AA AY A 
串联 起 更 多 函数 。 串 联 多 个 函数 可 以 让 程序 执行 更 多 动作 ， 这 种 做 法 有 
时 候 也 称 为 管道 处 理 (pipeline processing) ， 如 图 3-4 所 示 。 


执行 指定 的 操作 





输入 





执行 指定 的 操作 


f1 


输出 
执行 指定 的 操作 


举 个 例子 ， 如 果 我 们 还 有 一 个 protect 函数 ， 它 会 在 调用 传 入 的 处 
理 器 之 前 验证 用 户 的 身份 : 

















图 3-4 ”串联 更 多 处 理 器 








func protect(h http.HandlerFunc) http.HandlerFunc { 
return func(w http.ResponsewWriter, r *http.Request) { 








ONS THe, KEAK T BATRA Soe E A AS 


那么 我 们 只 需要 把 protect 函数 跟 之 前 的 函数 串联 在 一 起 ， 束 可 以 正常 
使 用 这 个 函数 了 : 


http.HandleFunc("/hello", protect(log(hello))) 


你 可 能 已 经 注意 到 了 ， 虽 然 我 们 一 直 讨 论 的 都 是 如 何 串联 处 理 器 ， 
但 代码 清单 3-10 实 际 上 却 是 在 串联 处 理 絮 了 阔 数 。 不 过 正如 代码 清单 3-11 
所 示 ， 串 联 处 理 器 的 方法 实际 上 和 串联 处 理 器 函数 的 方法 是 非常 相似 
的 。 


























代码 清单 3-11 上 串联 多 个 处 理 器 























package main 


import ( 
"fmt" 
"net/http" 
) 


type HelloHandler struct{} 


func (h HelloHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello!") 
} 


func log(h http.Handler) http.Handler { 


return http.HandlerFunc (func(w http.ResponseWriter, r *http.Request) 
{ 


fmt.Printf("Handler called - %T\n", h) 
h.ServeHTTP (w, r) 
}) 
} 


func protect(h http.Handler) http.Handler { 
return http.HandlerFunc (func(w http.ResponseWriter, r *http.Request) 


{ 
<... 0 
h.ServeHTTP (w, r) 
}) 
} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 

hello := HelloHandler{} 
http.Handle("/hello", protect(log(hello))) 
server.ListenAndServe() 





ONS TH ine, KEBK T BATRA Se E A RS 








让 我 们 来 观察 一 下 代码 清单 3-11 和 代码 清单 3-10 有 什么 区 别 。 代 码 
清单 3-11 中 的 Hello Handler 在 前 面 的 代码 清单 中 己 经 展示 过 ， 它 跟 
代码 清单 3-10 中 的 hello 函数 一 样 ， 都 位 于 串联 链 的 末尾 。 人 至 于 log A 
数 则 不 再 接受 和 返回 HandlerFunc 类 型 的 函数 ， 而 是 接受 并 返回 
Handler 类 型 的 处 理 器 : 
func log(h http.Handler) http.Handler { 


return http.HandlerFunc (func(w http.ResponsewWriter, r *http.Request) 


{ 
fmt.Printf ("Handler called - %T\n", h) 
h.ServeHTTP (w, r) 


}) 








log 函数 和 protect 函数 现在 不 再 返回 匿名 函数 ， 的 
用 HandlerFunc 直接 将 匿名 函数 转换 成 一 个 Handler ， 然 后 返 
个 Handler 。 程 序 现在 也 不 再 直接 执行 处 理 器 函数 了 ， uaa 
的 ServeHTTP 函数 。 最 后 的 一 点 变化 是 ， 程 序 现在 绑 定 的 是 处 理 器 而 不 
Fe Ah FE as PAI: 











hello := HelloHandler{} 
http.Handle("/hello", protect(log(hello) )) 


除了 以 上 提 到 的 区 别 之 外 ， 两 个 程序 的 其 余 代码 基本 上 都 是 相同 
的 。 


串联 处 理 器 和 处 理 器 函数 是 一 种 非常 常见 的 惯用 法 ， 很 多 Web 应 用 
框架 都 使 用 了 这 一 技术 。 


3.3.5 ServeMux 和 DefaultServeMux 


本 章 和 前 一 章 都 对 ServeMux 和 DefaultServeMux 进行 了 介 
绍 。ServeMux 是 一 个 HTTP 请 求 多 路 复 用 器 ， 它 负责 接收 HTTP 请 求 并 
根据 请 求 中 的 URL 将 请 求 重 定 同 到 正确 的 处 理 器 ， 如 图 3-5 所 示 。 


ss 





/hello 





多 路 复 用 器 : 


ServeMux 








/world 
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图 3-5 ”通过 多 路 复 用 器 将 请 求 转发 给 各个 处 理 器 











ServeMux 结构 包含 了 一 个 上 映射， 这 个 映射 会 将 URL 映 射 至 相应 的 
处 理 器 。 正 如 之 前 所 说 ， 因 为 ServeMux 结构 也 实现 了 ServeHTTP 方 
法 ， 所 以 它 也 是 一 个 处 理 器 。 当 ServeMux 的 ServeHTTP 方法 接收 到 一 
个 请 求 的 时 候 ， 它 会 在 结构 的 映射 里 面 找 出 与 被 请 求 URL 最 为 匹配 的 
URL， 然 后 调用 与 之 相对 应 的 处 理 器 的 ServeHTTP 方法 ， 如 图 3-6 所 
示 。 


ss Ae 
indexHandler 
请 求 
/hello helloHandler helloHandler 
GET /hello HTTP/1.1 
worldHandler 
worldHandler 


这 个 结构 负责 将 URL ServeMux 结 构 的 ServeHTTP 
映射 至 处 理 器 。 方法 会 调用 URL 对 应 的 处 理 器 
的 ServeHTTP 方 法 。 
































图 3-6 ”多 路 复 用 器 的 工作 原理 











在 介绍 完 ServeMux 之 后 ， 让 我 们 来 了 解 一 下 DefaultServeMux 。 
因为 ServeMux 是 一 个 结构 而 不 是 一 个 接口 ， 所 以 DefaultServeMux 并 
不 是 ServeMux 的 实现 。Default-ServeMux 实际 上 是 ServeMux 的 一 
个 实例 ， 并 且 所 有 引入 了 net/http 标准 库 的 程序 都 可 以 使 用 这 个 实 
例 。 当 用 户 没 有 为 Server 结构 指定 处 理 占 时 ， 服 务 占 就 会 使 
用 DefaultServeMux 作为 ServeMux 的 默认 实例 。 


此 外 ， 因 为 ServeMux 也 是 一 个 处 理 嚣 ， 所 以 用 户 也 可 以 在 有 需要 
的 情况 下 对 其 实例 实施 处 理 器 串联 。 





在 上 面 的 几 个 例子 中 ， 被 请 求 的 URL /hello 完美 地 匹配 了 与 多 路 
复 用 器 绑 定 的 URL， 但 如 果 浏 览 器 访问 的 是 /random 或 
者 /hello/there ， 那 么 服务 器 又 会 返回 什么 啊 应 呢 ? 


这 个 问题 的 答案 跟 我 们 绑 定 UREL 的 方法 有 关 : 如 果 我 们 像 图 3-6 那 
样 绑 定 根 URL (/) ， 那 么 匹配 不 成 功 的 URL 将 会 根据 URL 的 层级 进行 


下 降 ， 并 最 终 降落 在 根 URL 之 上 。 当 浏览 器 访问 /random 的 时 候 ， 因 为 
服务 器 无 法 找到 负责 处 理 这 个 URL 的 处 理 器 ， 所 以 它 会 把 这 个 URL 交 给 
根 URL 的 处 理 器 处 理 ( 对 于 图 中 所 示 的 例子 来 襄 ， 束 是 使 

用 indexHandler 来 处 理 这 个 URL ) 。 





那么 服务 器 又 是 如 何 处 理 /hello/there 的 呢 ? 根据 最 小 惊讶 原则 
(The Principle of Least Surprise) ， 因 为 程序 已 经 为 /hello 绑 定 了 处 理 
器 ， 所 以 在 默认 情况 下 ， 程 序 似乎 应 该 使 用 helloHandler 处 
理 /hello/there 。 但 是 对 图 3-6 所 示 的 例子 来 说 ， 服 务 器 实际 上 会 使 
用 indexHandler 去 处 理 对 /hello/there 的 请 求 。 





最 小 惊讶 原则 























最 小 惊讶 原则 ， 也 称 最 小 意外 原则 ， 是 设计 包括 软件 在 内 的 一 切 事物 的 一 条 通用 规则 ， 
它 指 的 是 我 们 在 进行 设计 的 时 候 ， 应 该 做 那些 合乎 常理 的 事情 ， 使 事物 的 行为 总 是 显 而 易 
见 、 始 终 如 一 并 且 合乎 情理 。 





















































举 个 例子 ， 如 果 我 们 在 一 扇 门 的 劳 边 放 置 一 个 按钮 ， 那 么 人 们 就 会 认为 这 个 按钮 与 这 局 
门 有 关 ， 比 如 ， 按 下 按钮 门铃 会 啊 或 者 门 会 自动 打开 ， 等 等 。 但 是 ， 如 果 这 个 按钮 被 按 下 时 
会 关 掉 走 请 的 灯光 ， 它 就 违反 了 最 小 尺 诈 原则 ， 因 为 这 一 行为 不 符合 人 们 对 这 个 按钮 的 预 
期 。 





























产生 这 种 行为 的 原因 在 于 程序 在 绑 定 helloHandler 时 使 用 的 URL 
xe/hello 而 不 是 /hello/ 。 如 果 和 被 绑 定 的 URL 不 是 以 / 结尾 ， 那 么 它 
只 会 与 完全 相同 的 URL 匹 配 ; 但 如 果 被 绑 定 的 URL 以 / 结尾 ， 那 么 即使 
请 求 的 URL 只 有 前 级 部 分 与 被 绑 定 URL 相 同 ，ServeMux 也 会 认定 这 两 
个 URL 是 匹配 的 。 





这 也 就 是 说 ， 如 果 与 helloHandler 处 理 器 绑 定 的 URL 是 /hello/ 
而 不 是 /hello ， 那 么 当 浏 览 器 请 求 /hello/there 的 时 候 ， 服 务 器 在 
找 不 到 与 之 完全 匹配 的 处 理 器 时 ， 就 会 退 而 求 其 次 ， 开 始 寻 找 能 够 
与 /hello/ 匹配 的 处 理 器 ， 并 最 终 找 到 helloHandler 处 理 器 。 








3.3.6 ”使 用 其 他 多 路 复 用 顺 


因为 创建 一 个 处 理 器 和 多 路 复 用 器 唯一 需要 做 的 就 是 实现 
ServeHTTP 方法 ， 所 以 通过 自行 创建 多 路 复 用 器 来 代替 net/http 包 中 
的 ServeMux 是 完全 可 行 的 ， 并 且 目 前 市 面 上 已 经 出 现 了 很 多 第 三 方 的 
多 路 复 用 器 可 供 使 用 ， 比 如 ，Gorilla Toolkit (www.gorillatoolkit.org ) 
就 是 一 个 非常 优秀 的 第 三 方 多 路 复 用 器 包 ， 它 提供 了 mux Mpat 这 两 个 
工作 方式 非常 不 同 的 多 路 复 用 器 ， 而 本 节 将 要 介绍 的 则 是 另 一 个 高 效 的 
轻 量 级 第 三 方 多 路 复 用 器 一 一 HttpRouter。 








ServeMux 的 一 个 缺陷 是 无 法 使 用 变量 实现 URL 模 式 匹配 。 虽 然 在 
浏览 器 请 求 /threads 的 时 候 ， 使 用 ServeMux 可 以 很 好 地 获取 并 显示 
论坛 中 的 所 有 帖子 ， 但 如 果 浏 览 器 请 求 的 是 /thread/123 ， 那 么 要 获 
取 并 显示 论坛 里 面 卫 为 123 的 帖子 就 会 变 得 非常 困难 。 程 序 必 须 对 URL 
进行 语法 分 析 才 能 提取 出 URL 当 中 的 帖子 ID。 此 外 ， 因 为 受 ServeMux 
实现 URL 模 式 匹 配 的 方式 所 限 ， 如 采 我 们 想 要 通 
过 /thread/123/post/456 这 样 的 URL 从 ID 为 123 的 帖子 中 获取 ID 为 
456 的 回复 ， 就 必须 在 程序 里 面 进行 大 量 复 杂 的 语法 分 析 ， 并 因此 给 程 
序 带 来 额外 的 复杂 度 。 











与 ServeMux 不 同 ，HttpRouter 包 并 没有 上 面 提 到 的 这 些 限 制 。 


本 市 将 对 HttpRouter 包 最 重要 的 一 部 分 特性 进行 介绍 ， 关 于 这 个 包 的 
更 详细 的 说 明 可 以 在 它 的 文档 页 面 里 面 看 到 ; 
https://github.com/julienschmidt/httprouter。 代 码 清 单 3-12 展 示 了 一 个 使 用 
HttpRouter 实 现 的 服务 器 。 











代码 清单 3-12 ”使 用 HttpRouter 实 现 的 服务 器 

















package main 


import ( 
"fmt" 
"github.com/julienschmidt/httprouter" 
"net/http" 

) 


func hello(w http.ResponseWriter, r *http.Request, p httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name")) 


} 


func main() { 
mux := httprouter.New() 
mux.GET("/hello/:name", hello) 


server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 


} 


server.ListenAndServe() 





这 个 程序 中 的 大 部 分 代码 都 和 之 前 展示 过 的 代码 一 样 ， 只 是 涉及 多 
路 复 用 器 的 部 分 代码 跟 之 前 有 所 不 同 。 在 这 段 代 码 里 ， 程 序 通 过 调 
用 New 函数 来 创建 一 个 多 路 复 用 器 : 


mux := httprouter.New() 


这 个 程序 不 再 使 用 HandleFunc 3b re Mb 48 KZO i ee BFE A 
器 函数 与 给 定 的 HITTP 方 法 进行 绑 定 : 


mux.GET("/hello/:name", hello) 


这 段 代 码 会 把 给 定 URL 的 GET 方法 与 hello 处 理 器 函数 进行 绑 定 ， 
当 浏 览 器 向 这 个 URL 发 送 6ET 请 求 时 ，hello 函数 就 会 被 调用 ， 但 如 果 
浏览 器 向 这 个 URL 发 送 除 GET 请 求 之 外 的 其 他 请 求 ，hello 函数 则 不 会 
被 调用 。 需 要 注意 的 是 ， 被 绑 定 的 URL 包 含 了 具名 参数 (named 
parameter) ， 这 些 具 名 参数 会 被 URL 中 的 具体 值 所 代替 ， 并 且 程 序 可 以 
在 处 理 器 里 面 获 取 这 些 值 。 





跟 之 前 的 处 理 器 函数 相 比 ， 现 在 的 hello 处 理 器 函数 也 发 生 了 变 
化 ， 它 不 再 接受 两 个 参数 ， 而 是 接受 3 个 参数 。 ae 
就 包含 了 之 前 提 到 的 具名 参数 ， 有 具名 参数 的 值 可 以 在 处 理 器 内 部 通 
ByName 方法 获取 : 





func hello(w http.ResponseWriter, r *http.Request, p httprouter.Params) { 
fmt.Fprintf(w, "hello, %s!\n", p.ByName("name")) 


} 





程序 的 最 后 一 个 变化 是 它 不 再 使 用 默认 的 DefaultServeMux ， 而 
通过 将 HttpRouter 传 递 给 Server 结构 来 使 用 这 个 多 路 复 用 器 : 





server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 


} 


server.ListenAndServe() 


现在 ， 如 果 我 们 在 终端 上 执行 go build 命令 ， 那 么 编译 器 将 返回 


一 个 错误 : 


$ go build 
server.go:5:5: cannot find package "github.com/julienschmidt/httprouter" i 
n 

any of: 


/usr/local/go/src/github.com/julienschmidt/httprouter (from $GOROOT) 
/Users/sausheong/gws/src/github.com/julienschmidt/httprouter (from $GO 
PATH) 








出 现 这 个 错误 的 原因 在 于 ， 我 们 虽然 指定 了 HttpRoter 库 ， 但 这 个 第 
三 方 库 在 我 们 的 电脑 上 并 不 存在 ， 得 益 于 Go 语言 强大 且 易 用 的 包 管 理 
系统 ， 我 们 只 需要 执行 以 下 命令 就 可 以 解决 这 个 问题 了 : 


$ go get github.com/julienschmidt/httprouter 


在 电脑 连接 了 网 络 的 情况 下 ， 这 个 命令 会 从 HttpRouter 的 GitHub 主 
页 上 下 载 HttpRouter 包 的 源 代码 ， 并 将 其 存储 到 $GOPATH/src 目录 中 。 
在 此 之 后 ， 当 我 们 再 次 执行 go build 命令 尝试 编译 代码 清单 3-12 所 示 
的 服务 器 时 ， 编 译 器 就 会 导入 HttpRouter 的 代码 ， 并 对 整个 服务 器 进行 
编译 。 





3.4 使 用 HTTP/2 


在 本 章 的 最 后 ， 让 我 们 来 了 解 一 下 如 何 使 用 HITP/2 构 建 本 章 介 绍 
的 Web 服 务 器 。 








本 书 在 第 1 章 已 经 对 HITP/2 做 过 简单 的 介绍 ， 并 且 提 到 过 在 1.6 或 以 
上 版 本 的 Go 语言 中 ， 如 果 使 用 HTTPS 模 式 启动 服务 器 ， 那 么 服务 器 将 
默认 使 用 HTTP/2。 但 是 ， 在 默认 情况 下 ， 版 本 低 于 1.6 版 本 的 Go 语言 将 
不 会 安装 http2 包 ， 因 此 用 户 需 要 通过 手动 执行 以 下 命令 来 获取 这 个 
包 : 


go get "golang.org/x/net/http2" 


为 了 让 代码 清单 3-6 中 构建 的 Web 服务器 用 上 HTTP/2， 我 们 需要 给 
这 个 服务 器 导入 http2 包 ， 并 通过 添加 一 些 代 码 行 来 让 服务 器 打开 对 
HTTP/2 的 支持 。 为 了 做 到 这 一 点 ， 我 们 需要 调用 http2 包 中 的 
ConfigureServer 方法 ， 并 将 服务 器 配置 传递 给 它 ， 修 改 后 的 服务 器 
代码 如 代码 清单 3-13 所 示 。 


代码 清单 3-13 ”启用 HTTP/2 





package main 


import ( 
"fmt" 
"golang.org/x/net/http2" 
"net/http" 

) 


type MyHandler struct{} 


func (h *MyHandler) ServeHTTP (w http.ResponseWriter, r *http.Request) { 
fmt.Fprintf(w, "Hello World!") 
} 


func main() { 
handler := MyHandler{} 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: &handler, 


http2.ConfigureServer(&server, &http2.Server{}) 


server.ListenAndServeTLS("cert.pem", "key.pem") 


} 








ME, FRAT BAT A FRED Da kN ITIP SAT TP/2 Die 
Websha ae J : 


go run server.go 


为 了 检查 服务 器 是 否 运 行 在 HTTP/2 模 式 之 下 ， 我 们 可 以 使 用 cURL 
对 服务 器 进行 检查 。 因 为 cURL 在 很 多 平台 上 都 是 可 用 的 ， 所 以 本 书 会 





经 第 使 用 它 作 为 检测 工具 ， 因 此 现在 是 时 候 来 学 习 一 下 如 何 使 用 cURL 
Ja 








cURL 是 一 个 命令 行 工 具 ， 它 可 以 获取 指定 URL 上 的 文件 ， 又 或 者 向 指定 的 URL 发 送 文 
件 。cURL 支 持 数 量 庞大 的 常用 互联 网 协议 ， 其 中 就 包括 HTTP 和 HTTPS。cURL 默 认 安 装 在 包 
括 OS X 在 内 的 很 多 Unix 变 种 之 上 ， 并 且 它 同样 可 以 在 Windows 系 统 上 使 用 。 手 动 下 载 和 安装 


















































cURL 的 方法 可 以 通过 页 面 http://curl.haxx.se/download.html 看 到 |。 














cURL 从 7.43.0 版 本 开始 支持 HTTP/2， 用 户 在 发 送 请 求 的 时 候 ， 只 
需要 打开 --http2 标志 (flag) 就 可 以 发 送 HTTP/2 请 求 了 。 此 外 ， 为 了 
让 cURL 能 够 支持 HTTP/2， 用 户 还 必须 将 cURL 与 nghttp2 这 个 提供 
HTTP/2 支 持 的 C 语 言 库 进行 链接 Cink) 。 在 撰写 本 节 的 时 候 ， 包 括 OS 
X 平 台 在 内 的 很 多 默认 的 cURL 实现 都 还 没有 提供 对 HTTP/2 的 支持 ， 因 
此 我 们 可 能 需要 重新 编译 cURL， 将 它 与 nghttp2 库 进行 链接 ， 然 后 用 
编译 后 的 新 版 cURL 代 蔡 原 有 的 CURL。 





在 完成 重新 编译 cURL 的 工作 之 后 ， 我 们 可 以 使 用 以 下 命令 去 检查 
代码 清单 3-13 展 示 的 Web 应 用 是 否 启 用 了 HTTP/2: 


curl -I --http2 --insecure https://localhost:8080/ 


在 默认 情况 下 ，cURL 在 以 HTTP/2 形 式 访问 一 个 Web 应 用 的 时 候 ， 
会 对 应 用 的 证 书 进行 验证 ， 并 在 验证 无 法 通过 时 拒绝 访问 。 因 为 我 们 的 
Web 应 用 使 用 的 是 自行 创建 的 证 书 和 密 钥 ， 它 们 默认 是 无 法 通过 这 一 验 
证 的 ， 所 以 上 面 的 命令 在 调用 cURL 的 时 候 使 用 了 insecure 标志 ， 这 个 
标志 会 让 cURL 强制 接受 我 们 创建 的 证 书 ， 从 而 使 访问 可 以 顺利 进行 。 


如 果 一 切 顺利 ，cURL 将 返回 以 下 输出 : 


HTTP/2.0 200 
content-type:text/plain; charset=utf-8 
content-length:12 


date:Mon, 15 Feb 2016 05:33:01 GMT 





本 章 虽 然 详 细 介 绍 了 如 何 接收 HTTP 请 求 ， 但 是 并 没有 有 具体 地 说 明 
如 何 处 理 接收 到 的 请 求 ， 以 及 如 何 向 客户 端 返 回响 应 。 虽 然 处 理 器 和 处 
理 霹 函数 是 使 用 Go 编写 Web 应 用 的 关键 ， 但 如 何 处 理 请 求 以 及 如 何 发 送 
响应 才 是 web 应 用 真正 安身 立 命 之 所 在 。 在 接 下 来 的 一 章 中 ， 我 们 将 深 
入 学 习 请 求 和 响应 的 细节 ， 了 解 如 何 从 请 求 中 提取 信息 ， 以 及 如 何 通过 
啊 应 传递 信息 。 











3.5 N24 


Go 语言 拥有 一 系列 成 熟 的 标准 库 ， 如 net/http 和 html/template 
， 这 些 标准 库 可 以 用 于 构建 Web 应 用 。 

尽管 使 用 Web 框 架 可 以 更 容易 并 且 更 快捷 地 构建 Web 应 用 ， 但 是 在 
使 用 这 些 框架 之 前 ， 先 了 解 Web 编 程 所 需 的 基础 知识 也 是 非常 重要 
的 。 

Go 语言 的 net/http 标准 库 可 以 将 HTTP 通信 放 到 SSL 之 上 进行 ， 也 
就 是 通过 HTTPS 方 式 创建 出 更 为 安全 的 通信 连接 。 

Go 语言 的 处 理 器 可 以 是 任何 市 有 ServeHTTP 方法 的 结构 ， 其 中 
ServeHTTP 方法 需要 接收 两 个 参数 : 第 一 个 参数 是 一 个 
ResponseWriter 接口 ， 而 第 二 个 参数 则 是 一 个 指向 Request 结构 
的 指针 。 

处 理 器 函数 是 与 处 理 器 拥有 相似 行为 的 函数 。 处 理 器 函数 用 于 处 理 
请 求 ， 它 们 跟 ServeHTTP 方法 拥有 相同 的 签名 。 

通过 串联 处 理 器 或 者 处 理 器 函数 ， 可 以 对 程序 中 的 横 切 关注 点 进行 
分 隔 ， 并 以 模块 化 的 方式 处 理 请 求 。 

多 路 复 用 器 也 是 处 理 器 。 比 如 ， ServeMux 就 是 一 个 HTTP 请 求 多 路 
复 用 器 ， 它 接受 HTTP 请 求 并 根据 请 求 中 的 URL 将 请 求 重 定向 到 正 
确 的 处 理 器 。 Defau1ltSserveMux 是 ServeMux 的 一 个 公开 的 实例 ， 
这 个 实例 会 被 用 作 默 认 的 多 路 复 用 器 。 

在 Go 1.6 或 以 上 的 版 本 中 ，net/http 标准 库 默 认 支 持 HTTP/2。 版 
本 低 于 1.6 的 Go 语言 如 果 想 要 获得 HITP/2 文 持 ， 就 需要 手动 添加 
http2 包 。 











Bae ”处 理 请 求 


本 章 主要 内 容 


。 使 用 Go 发 送 请 求 和 响应 

。 使 用 Go 处 理 HTML 表 单 

。 使 用 ResponseWriter 向 客户 端 回 传 响应 
e 使 用 cookie 存 储 信息 

。 使 用 cookie 实 现 闪 现 消 息 


在 前 一 章 ， 我 们 学 习 了 如 何 使 用 Go 语言 内 置 的 net/Vhttp 库 创建 
Web 应 用 服务 器 ， 并 厌 此 了 解 了 处 理 器 、 处 理 器 函数 以 及 多 路 复 用 器 。 
在 学 会 了 如 何 接收 请 求 并 将 请 求 转发 给 相应 的 处 理 器 之 后 ， 本 章 我 们 要 
学 习 的 是 如 何 使 用 Go 提供 的 工具 来 处 理 请 求 ， 以 及 如 何 把 啊 应 回 传 给 
客户 端 。 


4.1 请 求 和 啊 应 


本 书 的 第 1 革 对 HTTP 报 文 做 了 不 少 介绍 ， 为 了 加 深 印 象 、 防 止 遗 
迄 ， 让 我 们 先 来 回顾 一 下 这 方面 的 知识 。HTTP 报 文 是 在 客户 端 和 服务 
器 之 间 传 递 的 消息 ， 它 分 为 HTTP 请 求 和 HTTP 啊 应 两 种 类 型 ， 并 且 这 两 
种 类 型 的 报 文部 拥有 相同 的 结构 : 


请 求 行 或 者 啊 应 行 ; 


WY 


(1 


零 个 或 多 个 首部 ; 


WY 


(2 
(3) 一 个 空 行 ; 


一 个 可 选 的 报 文 主体 。 


WY 


(4 
下 面 是 一 个 GET 请 求 的 例子 : 


GET /Protocols/rfc2616/rfc2616.html HTTP/1.1 
Host: www.w3.org 
User-Agent: Mozilla/5.0 


(empty line) 





Go 语言 的 net/http 库 提供 了 一 系列 用 于 表示 HTTP 报 文 的 结构 ， 
为 了 学 习 如 何 使 用 这 个 库 处 理 请 求 和 发 送 响应 ， 我 们 必须 对 这 些 结构 有 
所 了 解 。 首 先 ， 让 我 们 来 看 看 net/http 库 中 代表 HTTP 请 求 报 文 的 
Request 结构 。 


4.1.1 ” Request 结构 


Request 结构 表示 一 个 由 客户 端 发 送 的 HITP 请 求 报 文 。 虽 然 HITP 
请 求 报 文 是 由 一 系列 文本 行 组 成 的 ， 但 Request 结构 并 不 是 完全 按照 报 
文 逐 字 逐 名 定义 的 。 实 际 情况 是 ， 这 个 结构 只 包含 了 报 文 在 经 过 语法 分 
析 之 后 ， 其 中 较为 重要 的 信息 ; 除 此 之 外 ， 这 个 结构 还 有 一 系列 相应 的 
方法 可 供 使 用 。 





Request 结构 主要 由 以 下 部 分 组 成 : 


。 URL 字段 ; 

e Header 字段 ; 

e Body 字段 ; 

。 Form 字段 、 PostForm 字段 和 MultipartForm 字段 。 





通过 Request 结构 的 方法 ， 用 户 还 可 以 对 请 求 报 文中 的 cookie、 引 
用 URL 以 及 用 户 代 理 进行 访问 。 当 net/http 库 被 用 作 HTTP 客户 端的 时 
候 ，Request 结构 既 可 以 用 于 表示 客户 端 将 要 发 送 给 服务 器 的 请 求 ， 也 
可 以 用 于 表示 服务 器 接收 到 的 客户 端 请 求 。 





4.1.2 KURL 

Request 结构 中 的 URL 字段 用 于 表示 请 求 行 中 包含 的 URL (请 求 行 
也 就 是 HTTP 请 求 报 文 的 第 一 行 ) ， 这 个 字段 是 一 个 指向 urlL.URL 结构 
的 指针 ， 代 码 清单 4-1 展 示 了 这 个 结构 的 定义 。 








代码 清单 4-1 URL 结构 





type URL struct { 
Scheme string 
Opaque string 
User *Userinfo 


Host string 
Path string 
RawQuery string 
Fragment string 





URE 的 一 般 格 式 为 : 


scheme://[userinfo@]host/path[?query][#fragment] 


那些 在 scheme 之 后 不 带 斜 线 的 URL 则 会 被 解释 为 : 


scheme:opaque[ ?query | [#fragment ] 


在 开发 Web 应 用 的 时 候 ， 我 们 第 凋 会 让 客户 端 通过 URL 的 查询 参数 





向 服务 器 传递 信息 ， 而 URL 结 构 的 RawQuery 字段 记录 的 就 是 客户 端 向 
服务 器 传递 的 查询 参数 字符 串 。 举 个 例子 ， 如 果 客 户 端 问 地 
址 http://www.example.com/post?id=123&thread_id=456 发 送 一 个 请 求 ， 
那么 RawQuery 字段 的 值 就 会 被 设置 为 d=123&thread_id=456 。 虽 然 
通过 对 RawQuery 字段 的 值 进行 语法 分 析 可 以 获取 到 键 值 对 格式 的 查询 
参数 ， 但 直接 使 用 Request 结构 的 Form 字段 来 获取 这 些 键 值 对 会 更 方 
便 一 些 。 本 章 稍 后 就 会 对 Request 结构 的 Form 字段 、PostForm 字段 和 
MultipartForm 字段 进行 介绍 。 








男 外 需要 注意 的 一 点 是 ， 如 果 请 求 报 文 是 由 浏览 器 发 送 的 ， 那 么 程 
序 将 无 法 通过 URL 结构 的 Fragment 字段 获取 URL 的 片段 部 分 。 本 书 在 


第 1 章 中 就 提 到 过 ， 浏 览 器 在 加 服务 器 发 送 请 求 之 前 ， 会 将 URL 中 的 片 
段 部 分 吻 除 挥 一 一 因为 服务 器 接收 到 的 都 是 不 包含 片段 部 分 的 URL， 所 
以 程序 自然 也 无 法 通过 Fragment 字段 去 获取 URL 的 片段 部 分 了 ， 造 成 
这 个 问题 的 原因 在 于 浏览 器 ， 与 我 们 正在 使 用 的 net/http 库 无 

K. URL 结构 的 Fragment 字段 之 所 以 会 存在 ， 是 因为 并 非 所 有 请 求 都 
来 自 浏览 器 : 除了 浏览 器 发 送 的 请 求 之 外 ， 服 务 器 还 可 能 会 接收 到 
HTTP 客 户 端 库 、Angular 这 样 的 客户 端 框架 或 者 某 些 其 他 工具 发 送 的 请 
求 ;， 此 外 别 筷 了 ， 不 仅 服务 器 程序 可 以 使 用 Request 结构 ， 客 户 端 库 也 
同样 可 以 把 Request 结构 用 作 自 己 的 一 部 分 。 


4.1.3 请求 首部 


请 求 和 响应 的 首部 都 使 用 Header 类 型 描述 ， 这 种 类 型 使 用 一 个 映 
射 来 表示 HTTP 首部 中 的 多 个 键 值 对 。Header 类 型 拥有 4 种 基本 方法 ， 
这 些 方 法 可 以 根据 给 定 的 键 执 行 添加 、 删 除 、 获 取 和 设置 值 等 操作 。 








一 个 Header 类 型 的 实例 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 
而 键 的 值 则 是 由 任意 多 个 字符 串 组 成 的 切片 。 为 Header 类 型 设置 首部 
以 及 添加 首部 都 是 非常 简单 的 ， 但 了 解 这 两 种 操作 之 间 的 区 别 有 助 于 更 
好 地 理解 Header 类 型 的 构造 : 在 对 Header 执行 设置 操作 时 ， 给 定 键 的 
值 首 先 会 被 设置 成 一 个 空白 的 字符 串 切 片 ， 然 后 该 切片 中 的 第 一 个 元 素 
会 被 设置 成 给 定 的 首部 值 ， 而 在 对 Header 执行 添加 操作 时 ， 给 定 的 首 
部 值 会 被 添加 到 字符 串 切 片 已 有 元 素 的 后 面 ， 如 图 4-1 所 示 。 

















在 为 键 添 加 新 的 首部 值 时 ， 一 个 
新 元 素 将 被 追加 到 键 对 应 的 字符 
RIAA. 


键 值 











图 4-1 一 个 首部 就 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 值 为 字符 串 切片 





代码 清单 4-2 展 示 了 该 取 请 求 首部 的 方法 。 


代码 清单 4-2 ” 读 取 请 求 首部 





package main 


import ( 
n" fmt " 
"net/http" 
) 


func headers(w http.ResponseWriter, r *http.Request) { 
h := r.Header 
fmt.Fprintln(w, h) 

} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.HandleFunc("/headers", headers) 
server.ListenAndServe( ) 





这 个 代码 清单 中 展示 的 服务 器 跟 我 们 在 第 3 章 看 到 过 的 服务 器 基本 
上 是 一 样 的 ， 唯 一 的 区 别 在 于 这 个 服务 器 会 把 请 求 的 首部 打印 出 来 。 图 
4-2 展 示 了 在 OS X 系 统 的 Safari 浏 览 器 上 访问 这 个 服务 器 的 结 


eee < 127.0.0.1:8080/headers 


map[Connection: [keep-alive] Accept-Encoding: [gzip, deflate] 
Accept: 

[text /html,application/xhtml+xml,application/xml;qe0.9,*/*;q-0. 
8) User-Agent: [(Mozilla/S.0 (Macintosh; Intel Mac OS X 10 10 2) 
AppleWebKit/600.3.18 (KHTML, like Gecko) Version/8.0.3 
Safari/600.3.18] Accept-Language: (en-us) Dnt:[{1)) 








图 4-2 ”在 浏览 器 上 展示 的 首部 打印 结果 





如 果 想 要 获取 的 是 菏 个 特定 的 首部 ， 而 不 是 请 求 的 所 有 首部 ， 那 么 
可 以 把 服务 器 中 的 


:= r.Header 





PO 
这 样 一 来 ， 程 序 就 会 得 到 "Accept-Encoding" 键 的 首部 值 : 


[gzip, deflate] 


除 此 之 外 ， 我 们 还 可 以 使 用 以 下 语句 : 


h := r.Header.Get("Accept-Encoding") 





并 得 到 以 下 结 


gzip, deflate 


注意 以 上 两 条 语句 之 间 的 区 别 : 直接 引用 Header 将 得 到 一 个 字符 
串 切 片 ， 而 在 Header 上 调用 Get 方法 将 返回 字符 串 形式 的 首部 值 ， 其 
中 多 个 首部 值 将 使 用 逗号 分 隔 。 


4.1.4 ”请 求 主体 


请 求 和 响应 的 主体 都 由 Request 结构 的 Body 字段 表示 ， 这 个 字段 
是 一 个 io.Read Closer 接 口 ， 该 接口 既 包 含 了 Reader 接口 ， 也 包含 了 
Closer 接口 。 其 中 Reader 接口 拥有 Read 方法 ， 这 个 方法 接受 一 个 字 
Medea 并 在 执行 之 后 返回 被 读 取 内 容 的 字 市 数 以 及 一 个 可 选 的 

错误 作为 结果 ; 而 Closer 接口 则 拥有 Close 方法 ， 这 个 方法 不 接受 任 
何 参 数 ， 但 会 在 出 错时 返回 一 个 错误 。 同 时 包含 Reader 接口 和 Closer 





接口 意味 着 用 户 可 以 对 Body 字段 调用 Read 方法 和 Close 方法 。 作 为 例 
子 ， 代 码 清单 4-3 展 示 了 如 何 使 用 Read 方法 读 取 请 求 主体 的 内 容 。 














代码 清单 4-3” 读 取 请 求 主体 中 的 数据 














package main 


import ( 
"fmt" 
"net/http" 
) 


func body(w http.ResponseWriter, r *http.Request) { 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body ) 


fmt.Fprintln(w, string(body) ) 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/body", body) 
server.ListenAndServe() 


} 





这 段 程 序 首先 通过 ContentLength 方法 获取 主体 数据 的 字 节 长 
度 ， 接 着 根据 这 个 长 度 创 建 一 个 字 节 数组 ， 然 后 调用 Read 方法 将 主体 
数据 读 取 到 字 市 数组 中 。 





因为 GET 请 求 并 不 包含 报 文 主体 ， 所 以 如 果 我 们 想 eases 
器 ， 就 需要 给 它 发 送 POST 请 求 。 正 如 之 前 所 说 ， 浏 览 器 一 般 需 要 通过 
HTML 表 单 才 能 发 送 POST 请 求 ， 但 是 因为 本 书 在 下 一 节 才 会 开始 介绍 
HTML 表 单 ， 所 以 这 里 我 们 暂且 就 先 使 用 HTTP 客 户 端 来 测试 服务 器 。 








市 面 上 可 用 的 HITP 客 户 端 非常 多 ， 既 有 桌面 版 的 图 形 HTTP 客 户 端 ， 也 
有 浏览 器 插件 或 者 扩展 ， 还 有 cURL 等 命令 行程 序 可 供 选 择 。 


作为 例子 ， 以 下 命令 展示 了 如 何 使 用 cURL 同 服务 器 发 送 一 条 POST 


$ curl -id "first_name=sausheong&last_name=chang" 127.0.0.1:8080/body 





cURL 在 接收 到 啊 应 之 后 将 疝 用 户 返 回 一 段 完整 并 且 未 经 处 理 的 
HTTP 员 应 ， 其 中 位 于 空 行 之 后 的 就 是 HTTP 的 主体 。 以 下 展示 的 束 是 上 
面 的 cURL 命令 返回 的 啊 应 : 





HTTP/1.1 200 OK 

Date: Tue, 13 Jan 2015 16:11:58 GMT 
Content-Length: 37 

Content-Type: text/plain; charset=utf-8 


first_name=sausheong&last_name=chang 





因为 Go 语言 提供 了 诸如 FormValue 和 FormFile 这 样 的 方法 来 提取 
通过 POST 方法 提交 的 表单 ， 所 以 用 户 一 般 不 需要 自行 读 取 主体 中 未 经 
处 理 的 表单 ， 本 章 接 下 来 的 一 节 就 会 介绍 FormValue 和 FormFile 等 方 
法 。 





4.2 Go 与 HTML 表单 


在 学 习 如 何 从 POST 请 求 中 获取 表单 数据 之 前 ， 让 我 们 先 来 了 解 一 
下 HTML 表 单 。 在 绝 大 多 数 情 况 下 ，POST 请 求 都 是 通过 HTML 表 单 发 送 
的 ， 这 些 表单 看 上 去 通常 会 是 下 面 这 个 样子 : 


<form action="/process" method="post"> 
<input type="text" name="first name"/> 


<input type="text" name="last_name"/> 


<input type="submit"/> 
</form> 





<form> 标签 可 以 包围 文本 行 、 文 本 框 、 单 选 按钮 、 复 选 框 以 及 文 
件 上 传 等 多 种 HTML 表单 元 素 ， 而 用 户 则 可 以 把 想 要 传递 给 服务 咒 的 数 
据 输 入 到 这 些 元 素 里 面 。 当 用 户 按 下 发 送 按钮 、 又 或 者 通过 茶 种 方式 触 
发 了 表单 的 发 送 操作 之 后 ， 用 户 在 表单 中 输入 的 数据 就 会 家 发 送 全 服务 
AÑ o 





用 户 在 表单 中 输入 的 数据 会 以 键 值 对 的 形式 记录 在 请 求 的 主体 中 ， 
然后 以 HTTP POST 请 求 的 形式 发 送 至 服务 器 。 因 为 服务 器 在 接收 到 浏览 
器 发 送 的 表单 数据 之 后 ， 还 需要 对 这 些 数 据 进 行 语法 分 析 ， 从 而 提取 出 
数据 中 记录 的 键 值 对 ， 因 此 我 们 还 需要 知道 这 些 键 值 对 在 请 求 主 体 中 是 
如 何 格式 化 的 。 





HTML 表 单 的 内 容 类 型 (content type) 决定 了 POST 请 求 在 发 送 键 值 
对 时 将 使 用 何 种 格式 ， 其 中 ，HTML 表 单 的 内 容 类 型 是 由 表单 的 


enctype 属性 指定 的 : 


<form action="/process" method="post" enctype="application/x-www-form-urle 
ncoded"> 

<input type="text" name="first_name"/> 

<input type="text" name="last_name"/> 


<input type="submit"/> 
</form> 





enctype 属性 的 默认 值 为 application/x-www-form- 
urlencoded 。 浏 览 器 至少 需要 文 持 application/x-www-form- 
urlencoded 和 multipart/form-data 这 两 种 编码 方式 。 除 以 上 两 种 


编码 方式 之 外 ，HTML5 还 支持 text/plain 编码 方式 。 


如 果 我 们 把 enctype 属性 的 值 设 置 为 application/x-www-form- 
urlencoded ， 那 么 浏览 器 将 把 HTML 表 单 中 的 数据 编码 为 一 个 连续 
的 “长 查询 字符 串 ”(long query string) : 在 这 个 字符 串 中 ， 不 同 的 键 值 
对 将 使 用 & 符号 分 隔 ， 而 键 值 对 中 的 键 和 值 则 使 用 等 号 = 分 隔 。 这 种 编 
码 方 式 跟 我 们 在 第 1 章 看 到 过 的 URL 编 码 是 一 样 的 ，application/x- 
www-form- urlencoded 编 码 名 字 中 的 urlencoded 一 词 也 由 此 而 来 。 换 
句 话说 ， 一 个 application/x- www- form-urlencoded 编码 的 HTTP 
请 求 主体 看 上 去 将 会 是 下 面 这 个 样子 的 : 


first_name=sau%2@sheong&last_name=chang 


但 是 ， 如 果 我 们 把 enctype 属性 的 值 设 置 为 multipart/form- 
data ， 那 么 表单 中 的 数据 将 被 转换 成 一 条 MIME 报 文 : 表单 中 的 每 个 键 











值 对 都 构成 了 这 条 报 文 的 一 部 分 ， 并 且 每 个 键 值 对 都 带 有 它们 各 目的 内 
容 类 型 以 及 内 容 配置 〈disposition ) 。 以 下 是 一 个 使 
用 multipart/form-data 编码 对 表单 数据 进行 格式 化 的 例子 : 
WebKitFormBoundaryMPNjKpeO9cLiocMw 
Content-Disposition: form-data; name="first_name" 


sau sheong 
WebKitFormBoundaryMPNjKpeO9cLiocMw 


Content-Disposition: form-data; name="last_name" 


WebKitFormBoundaryMPNjKpeO9cLiocMw- - 





既然 表单 同时 支持 application/x-www-form-urlencoded 编码 
和 multipart/form-data 编码 ， 那 么 我 们 该 选择 使 用 哪 种 编码 呢 ? 答 
案 是 ， 如 末 表 单传 送 的 是 简单 的 文本 数据 ， 那 么 使 用 URL 编 码 格式 更 
好 ， 因 为 这 种 编码 更 为 简单 、 高 效 ， 并 且 它 所 需 的 计算 量 要 比 另 一 种 编 
码 少 。 但 是 ， 如 果 表 单 需要 传送 大 量 数据 (如 上 传 文件 ) 那么 使 
ees /form- data 编 码 格式 会 更 好 一 些 。 在 需要 的 情况 下 ， 用 户 
还 可 以 通过 Base64 编 码 ， 以 文本 方式 传送 二 进 制 数据 。 


到 目前 为 止 ， 我们 只 讨论 了 如 何 通 过 POST 请 求 发 送 表单 ， 但 实际 
上 通过 GET 请 求 也 是 可 以 发 送 表单 的 一 一 因为 HTML 表 单 的 method 属 
性 的 值 既 可 以 是 POST 也 可 以 是 GET ， 所 以 下 面 这 个 HTML 表 单 也 是 合法 
的 : 





<form action="/process" method="get"> 
<input type="text" name="first_name"/> 
<input type="text" name="last_name"/> 
<input type="submit"/> 


</form> 


因为 GET 请 求 并 不 包含 请 求 主体 ， 所 以 在 使 用 GET 方法 传递 表单 
时 ， 表 单数 据 将 以 键 值 对 的 形式 包含 在 请 求 的 URL 里 面 ， 而 不 是 通过 主 
体 传递 。 








在 了 解 了 HTML 表单 癌 服 务 器 传递 数据 的 方法 之 后 ， 让 我 们 回 到 服 
务 器 一 端 ， 学 习 一 下 如 何 使 用 net/http 库 来 处 理 这 些 表 单数 据 。 


4.2.1 Form 字 段 


上 一 节 曾 经 提 到 过 ， 为 了 提取 表单 传递 的 键 值 对 数据 ， 用 户 可 能 需 
要 亲自 对 服务 器 接收 到 的 未 经 处 理 的 表 蛙 数据 进行 语法 分 析 。 但 事实 
上 ， 因 为 net/http 库 已 经 提供 了 一 套用 途 相当 广泛 的 函数 ， 这 些 函 数 
一 般 都 能 够 满足 用 户 对 数据 提取 方面 的 需求 ， 所 以 我 们 很 少 需 要 上 自行 对 
表单 数据 进行 语法 分 析 。 








通过 调用 Request 结构 提供 的 方法 ， 用 户 可 以 将 URL、 主 体 又 或 者 
以 上 两 者 记录 的 数据 提取 到 该 结构 的 Form 、PostForm 和 
MultipartForm 等 字段 当中 。 跟 我 们 平常 通过 POST 请 求 获 取 到 的 数据 
一 样 ， 存 储 在 这 些 字 段 里 面 的 数据 也 是 以 键 值 对 形式 表示 的 。 使 
用 Request 结构 的 方法 获取 表单 数据 的 一 般 步 又 是 : 


(1) 调用 ParseForm 方法 或 者 ParseMultipartForm 方法 ， 对 请 
求 进 行 语 法 分 析 。 


(2) 根据 步骤 1 调用 的 方法 ， 访 问 相 应 的 Form 字段 、PostForm 字 


段 或 MultipartForm 字段 。 


代码 清单 4-4 展 示 了 一 个 使 用 ParseFornm 方法 对 表单 进行 语法 分 析 
的 例子 。 





代码 清单 4-4 ”对 表单 进行 语法 分 析 


package main 


import ( 
"fmt" 
"net/http" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
r.ParseForm() 
fmt.Fprintln(w, r.Form) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 











这 段 代 码 中 最 重要 的 就 是 下 面 这 两 行 : 


r.ParseForm() 
fmt.Fprintlin(w, r.Form) 





如 前 所 述 ， 这 段 代 码 首先 使 用 了 ParseFornm 方法 对 请 求 进行 语法 分 
析 ， 然 后 再 访问 Form 字段 ， 获 取 具 体 的 表单 。 


现在 ， 让 我 们 来 创建 一 个 短小 精 悍 的 HIML 表 单 ， 并 使 用 它 作 为 客 
户 端 ， 回 代码 清单 4-4 所 示 的 服务 器 发 送 请 求 。 请 创建 一 个 名 
为 client .html 的 文件 ， 并 将 以 下 代码 复制 到 该 文件 中 : 


<html> 

<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
<title>GoWebProgramming</title> 

</head> 

<body> 
<form action=http://127.0.0.1:8080/process Phello=world&thread=123 
method="post" enctype="application/x-www-form-urlencoded"> 


<input type="text" name="hello" value="sau sheong"/> 
<input type="text" name="post" value="456"/> 
<input type="submit"/> 
</form> 
</body> 
</html> 





这 个 HIML 表 单 可 以 完成 以 下 工作 : 


。 通过 POST 方法 将 表单 发 送 至 地 址 http://localhost:8080/process? 
hello=world&thread=123; 

。 通过 enctype 属性 将 表单 的 内 容 类 型 设置 为 application/x-www- 
form-urlencoded; 

。 将 hello=sau sheong 和 post=456 这 两 个 HTML 表 单 键 值 对 发 送 : 
服务 器 。 


需要 注意 的 是 ， 这 个 表单 为 相同 的 键 hello 提供 了 两 个 不 同 的 值 ， 
其 中 ， 值 wor1d 是 通过 URL 提 供 的 ， 而 值 sau sheong 则 是 通过 HTML 
表单 中 的 文本 输入 行 提供 的 。 


因为 客户 端 可 以 直接 在 浏览 器 上 运行 ， 所 以 我 们 并 不 需要 使 用 服务 
ARNA wipe PEARS + 我 们 要 做 的 就 是 使 用 浏览 器 打开 client.html 
文件 ， 然 后 点 击 表单 中 的 发 送 按钮 。 如 果 一 切 正 常 ， 浏 览 器 应 该 会 显示 
以 下 输出 : 


map[thread:[123] hello:[sau sheong world] post:[456] ] 


这 是 服务 器 在 对 请 求 进行 语法 分 析 之 后 ， 使 用 字符 串 形 式 显示 出 来 
的 未 经 处 理 的 Form 结构 。 这 个 结构 是 一 个 映射 ， 它 的 键 是 字符 串 ， 而 
键 的 值 是 一 个 由 字符 串 组 成 的 切片 。 因 为 映射 是 无 序 的 ， 所 以 你 看 到 的 
键 值 对 排列 顺序 可 能 和 这 里 展示 的 有 所 不 同 。 但 是 无 论 如 何 ， 这 个 映射 
总 是 会 包含 查询 值 hello=wor1d 和 thread=123 ， 还 有 表单 
值 hello=sau sheong 和 post=456 。 正 如 所 见 ， 这 些 值 都 进行 了 相应 
的 URL 解 码 ， 比 如 在 sau 和 sheong 之 间 就 能 够 正常 地 看 到 空格 ， 而 不 
是 编码 之 后 的 %26 。 











4.2.2 PostForm 字 段 


对 上 一 节 提 到 的 post 这 种 只 会 出 现在 表单 或 者 URL 两 者 其 中 一 个 
地 方 的 键 来 说 ， 执 行 语句 Pr.Form["post"] 将 返回 一 个 切片 ， 切 片 里 面 
包含 了 这 个 键 的 表单 值 或 者 URL 值 ， 就 像 这 样 : [456] 。 而 对 hello 这 
种 同时 出 现在 表单 和 URL 两 个 地 方 的 键 来 说 ， 执 行 语句 
r.Form["hello"] 将 返回 一 个 同时 包含 了 键 的 表单 值 和 URL 值 的 切 
片 ， 并 且 表 单 值 在 切片 中 总 是 排 在 URL 值 的 前 面 ， 束 像 这 样 : [sau 


sheong world] 。 





如 果 一 个 键 同 时 拥有 表单 键 值 对 和 URL 键 值 对 ， 但 是 用 户 只 想 要 获 
取 表 单 键 值 对 而 不 是 URL 键 值 对 ， 那 么 可 以 访问 Request 结构 的 
PostForm 字段 ， 这 个 字段 只 会 包含 键 的 表单 值 ， 而 不 包含 任何 同名 键 
的 URL 值 。 举 个 例子 ， 如 果 我 们 把 前 面 代码 中 的 r.Form 语句 改 
为 r.PostForm 语句 ， 那 么 程序 将 打印 出 以 下 结果 : 


map[post:[456] hello:[sau sheong]] 


上 面 这 个 输出 使 用 的 是 application/x-www-form-urlencoded 
内 容 类 型 ， 如 采 我 们 修改 一 下 客户 端的 HTML 表 单 ， 让 它 使 
用 multipart/form-data 作为 内 容 类 型 ， 并 对 服务 器 代码 进行 调整 ， 
让 它 重新 使 用 r.Form 语句 而 不 是 r.PostForm 语句 ， 那 么 程序 将 打印 
出 以 下 结果 : 


map[hello: [world] thread:[123]] 


因为 PostForm 字段 只 支持 application/x-www-form- 
urlencoded 编码 ， 所 以 现在 的 r.Form 语句 将 不 再 返回 任何 表单 值 ， 
而 是 只 返回 URL 查 询 值 。 为 了 解决 这 个 问题 ， 我 们 需要 通过 
MultipartForm 字段 来 获取 multipart/form-data 编码 的 表单 数据 。 








4.2.3 MultipartForm? £z 


为 了 取得 multipart/form-data 编码 的 表单 数据 ， 我 们 需要 用 
到 Request 结构 的 ParseMultipartForm 方法 和 MultipartForm 字 


段 ， 而 不 再 使 用 ParseForm 方法 和 Form 字段 ， 不 过 
ParseMultipartForm 方法 在 需要 时 也 会 自行 调用 ParseForm 方法 。 
现在 ， 我 们 需要 修改 代码 清单 4-4 中 展示 的 服务 器 程序 ， 把 原来 的 
ParseForm 方法 调用 以 及 打印 语句 蔡 换 成 以 下 两 条 语句 : 


r.ParseMultipartForm(1024) 
fmt.Fprintin(w, r.MultipartForm) 


这 里 的 第 一 行 代码 说 明了 我 们 想 要 从 multipart 编 码 的 表单 里 面 取出 
多 少 字 节 的 数据 ， 而 第 二 行 语句 则 会 打印 请 求 的 MultipartForm 字 
段 。 修 改 后 的 服务 器 在 执行 时 将 打印 以 下 结果 : 


&{map[hello:[sau sheong] post:[456]] map[]} 


因为 MultipartForm 字段 只 包含 表单 键 值 对 而 不 包含 URL 键 值 
对 ， 所 以 这 次 打印 出 来 的 只 有 表单 键 值 对 而 没有 URL 键 值 对 。 另 外 需要 
注意 的 是 ，MultipartForm 字段 的 值 也 不 再 是 一 个 映射 ， 而 是 一 个 包 
含 了 两 个 映射 的 结构 ， 其 中 第 一 个 映射 的 键 为 字符 串 ， 值 为 字符 串 组 成 
的 切 厂 ， 而 第 二 个 映射 则 是 空 的 一 一 这 个 映射 之 所 以 会 为 宇 ， 是 因为 它 
是 用 来 记录 用 户 上 传 的 文件 的 ， 关 于 这 个 映射 的 具体 信息 我 们 将 会 在 接 
下 来 的 一 节 看 到 。 








除了 上 面 提 到 的 几 个 方法 之 外 ，Request 结构 还 提供 了 另外 一 些 方 
法 ， 它 们 可 以 让 用 户 更 容易 地 获取 表单 中 的 键 值 对 。 其 中 ，FormValue 
方法 允许 直接 访问 与 给 定 键 相 关联 的 值 ， 就 像 访问 Form 字段 中 的 键 值 


对 一 样 ， 唯 一 的 区 别 在 于 : 因为 FormValue 方法 在 需要 时 会 自动 调 
用 ParseFornm 方法 或 者 ParseMultipartForm 方法 ， 所 以 用 户 在 执 
行 FormValue 方法 之 前 ， 不 需要 手动 调用 上 面 提 到 的 两 个 语法 分 析 方 


这 意味 着 ， 如 宋 我 们 把 以 下 语句 写 到 代码 清单 4-4 所 示 的 服务 器 程 


并 将 客户 端 表 单 的 enctype 属性 的 值 设置 为 application/x-www- 
form-urlencoded ， 那 么 服务 器 将 打印 出 以 下 结果 : 


sau sheong 


因为 FormValue 方法 即使 在 给 定 键 拥有 多 个 值 的 情况 下 ， 也 只 会 从 
Form 结构 中 取出 给 定 键 的 第 一 个 值 ， 所 以 如 果 想 要 获取 给 定 键 包含 的 
所 有 值 ， 那 么 就 需要 直接 访问 Form 结构 : 








fmt.Fprintln(w, r.FormValue("hello") ) 
fmt.Fprintlin(w, r.Form) 








上 面 这 两 条 语句 将 产生 以 下 输出 : 


sau sheong 
map[post:[456] hello:[sau sheong world] thread: [123] ] 


[L CR 


除了 访问 的 是 PostForm 字段 而 不 是 Form 字段 之 
Ah, PostFormValue 方法 的 作用 跟 上 面 介 绍 的 FormValue 方法 的 作用 
基本 相同 。 下 面 是 一 个 使 用 PostFormValue 方法 的 例子 : 


fmt.Fprintln(w, r.PostFormValue("hello")) 
fmt.Fprintln(w, r.PostForm) 








下 面 是 这 两 行 代码 的 输出 结果 : 


sau sheong 
map[hello:[sau sheong] post:[456] ] 





正如 结果 所 示 ，PostFormValue 方法 只 会 返回 表单 键 值 对 而 不 会 
返回 URL 键 值 对 。 


FormValue 方法 和 PostFormValue 方法 都 会 在 需要 时 自动 去 调 
用 ParseMultipartFornm 方法 ， 因 此 用 户 并 不 需要 手动 调 
用 ParseMultipartForm 方法 ， 但 这 里 也 有 一 个 需要 注意 的 地 方 〈 至 少 
对 于 Go 1.4 版 本 来 说 ): 如 果 你 将 表单 的 enctype 设置 成 了 
multipart/form-data ， 然 后 尝试 通过 FormValue 方法 或 
者 PostFormValue 方法 来 获取 键 的 值 ， 那 么 即使 这 两 个 方法 调用 了 
ParseMultipartForm 方法 ， 你 也 不 会 得 到 任何 结 


为 了 验证 这 一 点 ， 让 我 们 再 次 修改 服务 器 程序 ， 给 它 加 上 以 下 代 
人 码 : 


fmt.Fprintlin(w, " 5 .FormValue("hello")) 
fmt.Fprintln(w, " i .PostFormValue("hello")) 
fmt.Fprintlin(w, " a .PostForm) 


fmt.Fprintln(w, " Š .MultipartForm) 





以 下 是 在 表单 的 enctype Amultipart/form-data 的 情况 下 ， 服 
ast) EVLA A 


world 


map[ ] 


&{map[hello:[sau sheong] post:[456]] map[ ]} 





结果 中 的 第 一 行 返回 的 是 键 hello 的 值 ， 并 且 这 个 值 来 自 URL 而 不 
是 表单 。 至 于 结果 中 的 第 二 行 和 第 三 行 ， 则 证 明了 前 面 提 到 的 “使 
用 PostFormValue 方法 不 会 得 到 任何 值 ” 这 一 说 法 ， 而 PostForm 字段 
为 空 则 是 引发 这 一 现象 的 罪魁 祸首 。PostForm 字段 之 所 以 会 为 空 ， 是 
因为 FormValue 方法 和 PostFormValue 方法 分 别 对 应 Form 字段 和 
PostForm 字段 ， 而 表单 在 使 用 multipart/form-data 编码 时 ， 表 单 
数据 将 被 存储 到 MultipartForm 字段 而 不 是 以 上 两 个 字段 中 。 结 果 的 
最 后 一 行 证 明 ParseMultipartForm 方法 的 确 被 调用 了 一 一 用 户 只 要 访 
问 MultipartForm 字段 ， 就 可 以 取得 所 有 表单 值 。 








本 市 介绍 了 Request 结构 的 很 多 相关 字段 以 及 方法 ， 表 4-1 对 它们 
进行 了 回顾 ， 并 阐述 了 各 个 方法 之 间 的 区 别 。 除 此 之 外 ， 这 个 表 还 说 明 
了 调用 哪个 方法 可 以 取得 哪个 字段 的 值 ， 并 阐述 了 这 些 值 的 来 源 以 及 这 
些 值 的 类 型 。 比 如 ， 表 的 第 一 行 就 说 明了 ， 通 过 以 直接 或 间接 的 方式 调 








用 ParseForm 方法 ， 用 户 可 以 将 数据 存储 到 Form 字段 里 面 ， 然 后 用 户 
只 要 访问 Form 字段 ， 束 可 以 取得 编码 类 型 为 application/x-www- 
form-urlencoded 的 URL 数 据 和 表单 数据 。 对 表 4-1 中 列 出 的 字段 以 及 
方法 来 说 ， 它 们 唯一 令 人 感到 遗憾 的 地 方 就 是 ， 这 些 字 段 以 及 方法 的 命 
名 规范 并 不 是 特别 让 人 满意 ， 还 有 很 多 有 待 改善 的 地 方 。 























表 4-1 对 比 Form、PostForm 和 MultipartForm 字段 


键 值 对 的 来 源 型 
需要 调用 的 方法 或 
需要 访问 的 字段 
URL | 表单 |URL 编 码 | Multipart 编 码 
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42.4 文件 
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multipart/form-data 编码 通常 用 于 实现 文件 上 传 功 能 ， 这 种 功 
能 需要 用 到 file 类 型 的 Input 标签 。 代 码 清单 4-5 给 出 的 就 是 之 前 展示 





Ae im Fe EE SE CPE ERT RE ZR. SEH Ae 
现 的 是 新 增 或 者 经 过 修改 的 代码 。 


代码 清单 4-5 文件 上 传 


< html> 

< head> 
< meta http-equiv="Content-Type” content="text/html; charset=utf-8" /> 
< title>Go Web Programming< /title> 

< /head> 

< body> 
< form action="http://localhost:8080/process?hello=world&thread=123" 

method="post" enctype="multipart/form-data"> 


< input type="text" name="hello" value="sau sheong"/> 
< input type="text" name="post" value="456"/> 
< input type="file" name="uploaded"> 


< input type="submit"> 
< /form> 
< /body> 
< /html> 





为 了 能 够 接收 表 日 上 传 的 文件 ， 处 理 絮 函数 也 需要 做 相应 的 修改 ， 
具体 见 代 码 清单 4-6。 











代码 清单 4-6 ”通过 MultipartForm 字段 接收 用 户 上 传 的 文件 




















package main 


import ( 
"fmt" 
"io/ioutil" 
"net/http" 


func process(w http.ResponsewWriter, r *http.Request) { 
r.ParseMultipartForm(1024) 
fileHeader := r.MultipartForm.File[ "uploaded" ][@] 
file, err := fileHeader.Open() 


if err == nil { 
data, err := ioutil.ReadAll(file) 
if err == nil { 
fmt.Fprintlin(w, string(data) ) 
} 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 


} 





正如 之 前 所 说 ， 服 务 器 在 处 理 文 件 上 传 时 首先 要 做 的 就 是 执 
行 ParseMultipartForm Wiz, #24 MMultipartForm 字段 的 File 字 
段 里 面 取 出 文件 头 FileHeader ， 然 后 通过 调用 文件 头 的 Open 方法 来 打 
开 文 件 。 在 此 之 后 ， 服 务 器 会 将 文件 的 内 容 读 取 到 一 个 字 节 数组 中 ， 并 
将 这 个 字 节 数组 的 内 容 打印 出 来 。 现 在 ， 如 果 我 们 辣 服 务 嚣 上传 一 个 纯 
文本 文件 ， 那 么 服务 器 将 把 这 个 文件 的 内 容 打 印 在 浏览 器 上 。 


跟 FormValue 方法 和 PostFormValue 方法 类 似 ，net/http 库 也 
提供 了 一 个 FormFile 方法 ， 它 可 以 快速 地 获取 被 上 传 的 文 
fF: FormFile 方法 在 被 调用 时 将 返回 给 定 键 的 第 一 个 值 ， 因 此 它 在 客 
户 端 只 上 传 了 一 个 文件 的 情况 下 ， 使 用 起 来 会 非常 方便 。 代 码 清单 4-7 
展示 了 一 个 使 用 FormFile 方法 的 例子 。 











代码 清单 4-7 使 用 FormFile 方法 获取 被 上 传 的 文件 


func process(w http.ResponsewWriter, r *http.Request) { 
file, _, err := r.FormFile("uploaded" ) 
if err == nil { 
data, err := ioutil.ReadAll(file) 
if err == nil { 


fmt.Fprintin(w, string(data) ) 





正如 代码 所 示 ，FormFile 方法 将 同时 返回 文件 和 文件 头 作 为 结 
果 。 用 户 在 使 用 FormFile 方法 时 ， 将 不 再 需要 手动 调 
用 ParseMultipartForm 方法 ， 只 需要 对 返回 的 文件 进行 处 理 即 可 。 


4.2.5 “处理 带 有 JSON 主 体 的 POST 请 求 


因为 前 面 的 内 容 一 直 只 使 用 HTML 表 单 发 送 POST 请 求 ， 所 以 到 目 
前 为 止 ， 我 们 考虑 的 都 是 如 何 处 理 请 求 主 体 中 的 键 值 对 。 但 实际 上 ， 
POST 请 求 并 不 是 只 能 通过 HTML 表 单 发 送 : 诸如 jQuery 这 样 的 客户 端 
库 ， 又 或 者 是 Angular、Ember 这 样 的 客户 端 框架 ， 甚 至 是 Adobe Flash, 
Microsoft Silverlight 这 样 的 技术 ， 都 能 够 发 送 POST 请 求 ， 并 且 这 种 行为 
正在 变 得 越 来 越 常见 。 











需要 注意 的 是 ， 使 用 ParseFornm 方法 是 无 法 从 Angular 客 户 端 发 送 
的 POST 请 求 中 获取 JSON 数 据 的 ， 但 使 用 jQuery 这 样 的 JavaScript 库 却 不 
会 出 现 这 样 的 问题 。 





造成 这 一 区 别 的 原因 在 于 ， 不 同 客户 端 使 用 了 不 同 的 方式 编码 
POST 请 求 : jQuery 会 像 HTML 表 单一 样 ， 使 用 application/x-www- 


form-urlencoded 对 POST 请 求 进行 编码 〈 有 具体 做 法 是 ，jQuery 会 把 
POST 请 求 的 Content-Type 首部 的 值 设 置 为 application/Xx-www- 
form-urlencoded ) ， 而 Angular 在 编码 POST 请 求 时 使 用 的 却 

是 application/json 。 因 为 Go 语言 的 ParseFornm 方法 只 会 对 表单 数 
据 进 行 语法 分 析 ， 它 并 不 接受 application/json 编码 ， 所 以 使 用 这 一 
编码 发 送 POST 请 求 的 用 户 自然 也 无 法 通过 ParseFornm 方法 获得 任何 数 
据 。 


这 个 问题 跟 库 的 实现 无 关 ， 真 正 的 罪 风 祸首 实际 上 是 没有 尽 够 的 文 
档 对 这 种 行为 进行 说 明 ， 而 程序 员 又 对 他 们 使 用 的 框架 做 了 茶 种 假设 ， 
这 样 一 来 ， 问 题目 然而 然 地 也 束 出 现 了 。 


因为 框架 可 以 隐藏 复杂 性 和 实现 细节 ， 所 以 程序 员 应 该 使 用 框架 。 
但 与 此 同时 ， 理 解 框 架 的 工作 方式 ， 了 解 框 架 如 何 化 繁 为 简 ， 也 是 非常 
重要 的 。 否 则 ， 在 使 用 框 染 与 其 他 程序 进行 对 接 的 时 候 ， 就 可 能 会 出 现 
各 种 各 样 的 问题 。 





到 目前 为 止 ， 本 章 已 经 对 “如 何 处 理 请 求 ” 这 一 问题 做 了 足够 多 的 介 
绍 ， 现 在 ， 是 时 候 讲 讲 如 何 加 用户 友 送 啊 应 了 。 


4.3 ResponseWriter 


首先 创建 一 个 Response 结构 ， 接 着 将 数据 存储 到 这 个 结构 里 面 ， 
最 后 将 这 个 结构 返回 给 客户 端 一 一 如 果 你 认为 服务 器 是 通过 这 种 方式 问 
客户 端 返 回响 应 的 ， 那 么 你 就 错 了 : 服务 器 在 向 客户 端 返回 响应 的 时 
候 ， 真 正 需要 用 到 的 是 ResponseWriter 接口 。 





ResponseWriter 是 一 个 接口 ， 处 理 器 可 以 通过 这 个 接口 创建 
HTTP 啊 应 。ResponseWriter 在 创建 啊 应 时 会 用 到 http.response 44 
构 ， 因 为 该 结构 是 一 个 非 导 出 (Cnonexported) 的 结构 ， 所 以 用 户 只 能 通 
过 ResponseWriter 来 使 用 这 个 结构 ， 而 不 能 直接 使 用 它 。 


为 什么 要 以 传 值 的 方式 将 ResponseWriter 传 递 给 ServeHTTP 











在 阅读 了 本 章 前 面 的 内 容 之 后 ， 有 的 读者 可 能 会 感到 疑惑 一 一 ServeHTTP 为 什么 要 接受 
ResponseWriter 接口 和 一 个 指向 Request 结构 的 指针 作为 参数 呢 ? 接受 Request 结构 指针 
的 原因 很 简单 : 为 了 让 服务 器 能 够 察觉 到 处 理 器 对 Request 结构 的 修改 ， 我 们 必须 以 传 引用 

(pass by reference) 而 不 是 传 值 (pass by value) 的 方式 传递 Request 结构 。 但 是 另 一 方面 ， 
为 什么 ServeHTTP 却 是 以 传 值 的 方式 接受 ResponseWriter We? 难道 服务 器 不 需要 知道 处 理 


器 对 ResponseNriter 所 做 的 修改 吗 ? 






























































对 于 这 个 问题 ， 如 果 我 们 深入 探究 net/http 库 的 源码 ， 就 会 发 现 ResponseWriter 实际 
上 就 是 response 这 个 非 导 出 结构 的 接口 ， 而 ResponseWriter 在 使 用 response 结构 时 ， 传 
递 的 也 是 指向 response 结构 的 指针 ， 这 也 就 是 说 ，ResponseWriter 是 以 传 引用 而 不 是 传 值 
的 方式 在 使 用 response 结构 。 
























































换 句 话 说， 实际 上 ServeHTTP 函数 的 两 个 参数 传递 的 都 是 引用 而 不 是 值 一 一 虽 
然 ResponseWriter 看 上 去 像 是 一 个 值 ， 但 它 实际 上 却 是 一 个 带 有 结构 指针 的 接口 。 

















ResponseWriter 接口 拥有 以 下 3 个 方法 : 


e Write; 
e WriteHeader ; 


e Header 。 
对 ResponseWriter 进 行 写 入 


Write 方法 接受 一 个 字 市 数组 作为 参数 ， 并 将 数组 中 的 字 节 写 入 
HITP 啊 应 的 主体 中 。 如 果 用 户 在 使 用 Write 方法 执行 号 入 操作 的 时 
候 ， 没 有 为 首部 设置 相应 的 内 容 类 型 ， 那 么 啊 应 的 内 容 类 型 将 通过 检测 
被 写 入 的 前 512 字 市 决定 。 代 码 清单 4-8 展 示 了 Write 方法 的 用 法 。 














代码 清单 4-8 ”使 用 Write 方法 向 客户 端 发 送 响应 


package main 


import ( 
"net/http" 
) 


func writeExample(w http.ResponseWriter, r *http.Request) { 
str := “<html> 

<head><title>Go Web Programming</title></head> 

<body><h1>Hello World</h1></body> 

</html>` 


w.Write([]byte(str)) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
server.ListenAndServe() 





这 上 段 代 码 通 过 调用 Write 方法 将 一 段 HTML 字 符 串 写 入 了 HTTP 啊 
应 的 主体 中 。 向 服务 器 发 送 以 下 命令 : 


curl -i 127.0.0.1:8080/write 


我 们 可 以 得 到 以 下 啊 应 : 


HTTP/1.1 200 OK 

Date: Tue, 13 Jan 2015 16:16:13 GMT 
Content-Length: 95 

Content-Type: text/html; charset=utf-8 


<html> 
<head><title>GoWebProgramming</title></head> 
<body><h1>Hello World</h1></body> 

</html> 

















注意 ， 尽 管 我 们 没有 杀 目 为 啊 应 设置 内 容 类 型 ， 但 程序 还 是 通过 检 
测 自动 设置 了 正确 的 内 容 类 型 。 











WriteHeader 方法 的 名 字 带 有 一 点 儿 误 导 性 质 ， 它 并 不 能 用 于 设 
置 啊 应 的 首部 (Header 方法 才 是 做 这 件 事 的 ) : WriteHeader 方法 接 
受 一 个 代表 HTTP 啊 应 状态 码 的 整数 作为 参数 ， 并 将 这 个 整数 用 作 HTTP 
啊 应 的 返回 状态 码 ;， 在 调用 这 个 方法 之 后 ， 用 户 可 以 继续 对 
ResponseWriter 进行 写 入 ， 但 是 不 能 对 响应 的 首部 做 任何 写 入 操作 。 
如 果 用 户 在 调用 Write 方法 之 前 没有 执行 过 WriteHeader 方法 ， 那 么 
程序 默认 会 使 用 200 OK 作为 响应 的 状态 码 。 








WriteHeader 方法 在 返回 错误 状态 码 时 特别 有 用 : 如 果 你 定义 了 








PAPI, (Be HAAS ASB, BB Fe PA mV TA] SA PI 
的 时 候 ， 你 可 能 会 希望 这 个 API 返 回 一 个 561 Not Implemented, (KAS 
码 ， 代 码 清 单 4-9 通 过 添加 新 的 处 理 器 实现 了 这 一 需求 。 顺 带 一 提 ， 千 
万 别 筷 了 使 用 HandleFunc 方法 将 新 处 理 器 绑 定 到 DefaultServeMux 
多 路 复 用 器 里 面 ! 











代码 清单 4-9 通过 NriteHeader 方法 将 状态 码 写 入 到 响应 当 : 








package main 


import ( 
"fmt" 
"net/http" 


) 


func writeExample(w http.ResponseWriter, r *http.Request) { 
str := <html> 
<head><title>Go Web Programming</title></head> 
<body><h1>Hello World</h1></body> 
</html>~ 
w.Write([ ]byte(str) ) 
} 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintln(w, "No such service, try next door") 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
server.ListenAndServe() 





通过 cURL 访问 刚刚 添加 的 新 处 理 器 : 


curl -i 127.0.0.1:8080/writeheader 





我 们 将 得 到 以 下 啊 应 : 


HTTP/1.1 501 Not Implemented 

Date: Tue, 13 Jan 2015 16:20:29 GMT 
Content-Length: 31 

Content-Type: text/plain; charset=utf-8 


No such service, try next door 





最 后 ， 通 过 调用 Header 方法 可 以 取得 一 个 由 首部 组 成 的 映射 〈 关 
于 首部 的 有 具体 细节 在 4.1.3 节 曾经 讲 过 ) ， 修 改 这 个 映射 就 可 以 修改 首 
部 ， 修 改 后 的 首部 将 被 包含 在 HTTP 响 应 里 面 ， 并 随 着 响应 一 同 发 送 至 
客户 端 。 



































代码 清单 4-10 ”通过 编写 首部 实现 客户 端 重 定 问 

















package main 


import ( 
"fmt" 
"net/http" 
) 


func writeExample(w http.ResponseWriter, r *http.Request) { 
str := <html> 
<head><title>Go Web Programming</title></head> 
<body><h1>Hello World</h1></body> 
</html>~ 
w.Write([ ]byte(str) ) 
} 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintln(w, "No such service, try next door") 


func headerExample(w http.ResponsewWriter, r *http.Request) { 
w.Header().Set("Location", "http://google.com") 
w.WriteHeader (302) 

} 


func main() { 

server := http.Server{ 
Addr: "127.0.0.1:8080", 

} 
http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 
server.ListenAndServe() 





代码 清单 4-10 同 我 们 展示 了 如 何 实现 一 次 HTTP 重 定向 : 除了 将 状 
态 码 设置 成 了 382 之 外 ， 它 还 给 啊 应 添加 了 一 个 名 为 Location 的 首 
部 ， 并 将 这 个 首部 的 值 设置 成 了 重 定向 的 目的 地 。 需 要 注意 的 是 ， 
AwriteHeader 方法 在 执行 完毕 之 后 就 不 允许 再 对 首部 进行 写 入 了 ， 
所 以 用 户 必 须 先 写 入 Location 首部 ， 然 后 再 写 入 状态 码 。 现 在 ， 如 果 
我 们 在 浏览 器 里 面 访问 这 个 处 理 占 ， 那 么 浏览 器 将 被 重 定 问 到 Google。 


男 一 方面 ， 如 果 我 们 使 用 cURL 访问 这 个 处 理 器 : 


curl -i 127.0.0.1:8080/redirect 


那么 cURL 将 获得 以 下 啊 应 : 





HTTP/1.1 302 Found 

Location: http://google.com 

Date: Tue, 13 Jan 2015 16:22:16 GMT 
Content-Length: 6 

Content-Type: text/plain; charset=utf-8 


pO 


最 后 ， 让 我 们 来 学 习 一 下 通过 ResponseWriter 直接 向 客户 端 返 回 
JSON 数 据 的 方法 。 代 码 清单 4-11 展 示 了 如 何以 JSON 格 式 将 一 个 名 
为 Post 的 结构 返回 给 客户 端 。 


代码 清单 4-11 编写 JSON 输 出 























package main 


import ( 
"fmt" 
"encoding/json" 
"net/http" 

) 


type Post struct { 
User string 
Threads [ |string 


} 


func writeExample(w http.ResponseWriter, r *http.Request) { 
str := `<html> 
<head><title>Go Web Programming</title></head> 
<body><h1>Hello World</h1></body> 
</html>` 
w.Write([]byte(str)) 


} 


func writeHeaderExample(w http.ResponseWriter, r *http.Request) { 
w.WriteHeader (501) 
fmt.Fprintln(w, "No such service, try next door") 


} 


func headerExample(w http.ResponsewWriter, r *http.Request) { 
w.Header().Set("Location", "http://google.com") 
w.WriteHeader (302) 

} 


func jsonExample(w http.ResponseWriter, r *http.Request) { 
w.Header().Set("Content-Type", "application/json") 
post := &Post{ 


User: "Sau Sheong", 

Threads: []string{"first", "second", "third"}, 
} 
json, _ := json.Marshal(post) 
w.Write(json) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/write", writeExample) 
http.HandleFunc("/writeheader", writeHeaderExample) 
http.HandleFunc("/redirect", headerExample) 
http.HandleFunc("/json", jsonExample) 
server.ListenAndServe() 








这 段 代 码 中 的 jsonExample 处 理 器 就 是 这 次 的 主角 。 因 为 本 书 将 
在 第 7 章 进 一 步 介 绍 JSON 格 式 ， 所 以 不 了 解 JSON 格 式 的 读者 也 不 必 过 
于 担心 ， 目 前 来 说 ， 你 只 需要 知道 变量 json 是 一 个 由 Post 结构 序列 化 
而 成 的 JSON 字 符 串 就 可 以 了 。 





这 段 程序 首先 使 用 Header 方法 将 内 容 类 型 设置 





成 application/json ， 然 后 调用 Write 方法 将 JSON 字 符 串 写 
入 ResponseWriter 中 。 现 在 ， 如 果 我 们 执行 cURL 命令 : 





curl -i 127.0.0.1:8080/json 


那么 它 将 返回 以 下 啊 应 : 





HTTP/1.1 266 OK 
Content-Type: application/json 
Date: Tue, 13 Jan 2015 16:27:01 GMT 


Content-Length: 58 


{"User":"Sau Sheong","Threads":[ "first", "second", "third" ]} 





4.4 cookie 





本 书 在 第 2 草 曾 经 简单 地 介绍 过 如 何 使 用 cookie 创 建 身 份 验证 会 话 ， 
本 市 将 在 前 文 的 基础 上 ， 更 加 深入 地 研究 cookie 的 使 用 方法 ， 并 把 
cookie 应 用 在 更 为 常见 的 客户 端 持久 化 场景 中 ， 而 不 仅仅 用 它 创 建 会 
话 。 








cookie 是 一 种 存储 在 客户 端的 、 体 积 较 小 的 信息 ， 这 些 信 息 最 初 都 
是 由 服务 器 通过 HTTP 响 应 报 文 发 送 的 。 每 当 客 户 端 向 服务 器 发 送 一 个 
HTTP 请 求 时 ，cookie 都 会 随 着 请 求 被 一 同 发 送 衬 服务 器 。cookie 的 设计 
本 意 是 要 克服 HITP 的 无 状态 性 ， 虽 然 cookie 并 不 是 完成 这 一 目的 的 唯一 
方法 ， 但 它 却 是 最 常用 也 最 流行 的 方法 之 一 : 整个 计算 机 行业 的 收入 都 
建立 在 cookie 机 制 之 上 ， 对 互联 网 广告 领域 来 说 ， 更 是 如 此 。 





cookie 的 种 类 有 很 多 ， 其 中 一 些 还 拥有 非常 有 趣 的 名 字 ， 如 超级 
cookie、 第 三 方 cookie 以 及 僵尸 cookie。 但 总 的 来 说 ， 大 多 数 cookie 都 可 
以 被 划分 为 会 话 cookie 和 持久 cookie 两 种 类 型 ， 而 其 他 类 型 的 cookie 通 常 
都 是 持久 cookie 的 变种 。 


4.4.1 Go 与 cookie 


cookie 在 Go 语言 里 面 用 Cookie 结构 表示 ， 这 个 结构 的 定义 如 代码 
清单 4-12 所 示 。 





代码 清单 4-12 Cookie 结构 的 定义 





type Cookie struct { 
Name string 


Value string 


Path string 
Domain string 
Expires time.Time 
RawExpires string 
MaxAge int 
Secure bool 
HttpOnly bool 

Raw string 
Unparsed []string 





O AEDI 字段 的 cookie 通 常 称 为 会 话 cookie 或 者 临时 
cookie， 这 种 cookie 在 浏览 器 关闭 的 时 候 束 会 自动 被 移 除 。 相 对 而 言 ， 
设置 了 Expires 字段 的 cookie 通 常 称 为 持久 cookie， 这 种 cookie 会 一 直 存 
在 ， 直 到 指定 的 过 期 时 间 来 临 或 者 被 手动 删除 为 止 。 


Expires 字段 和 MaxAge 字段 都 可 以 用 于 设置 cookie 的 过 期 时 间 ， 
其 中 Expires 字段 用 于 明确 地 指定 cookie 应 该 在 什么 时 候 过 期 ， 
而 MaxAge 字段 则 指明 了 cookie 在 被 浏览 器 创建 出 来 之 后 能 够 存活 多 少 
秒 。 之 所 以 会 出 现 这 两 种 截然 不 同 的 过 期 时 间 设 置 方式 ， 是 因为 不 同 浏 
览 器 使 用 了 各 不 相同 的 cookie 实 现 机 制 ， 跟 Go 语言 本 喘 的 设计 无 关 。 虽 
SRATTP 1.1 中 废弃 了 Expires ， 推 荐 使 用 MaxAge 来 代替 Expires ， 但 
几乎 所 有 浏览 器 都 仍然 支持 Expires ; 而且， 微软 的 耻 6、IE 7 和 IE 8 都 
不 文 持 MaxAge 。 为 了 让 cookie 在 所 有 浏览 器 上 都 能 够 正常 地 运作 ， 
个 实际 的 方法 是 只 使 用 Expires ， 或 者 同时 使 用 Expires 和 MaxAge 。 





4.4.2 ”将 cookie 发 送 至 浏览 


Cookie 结构 的 String 方法 可 以 返回 一 个 经 过 序列 化 处 理 的 








cookie， 其 中 Set -Cookie 啊 应 首部 的 值 就 是 由 这 些 序列 化 之 后 的 cookie 
组 成 的 。 代 码 清单 4-13 展 示 了 如 何 使 用 string 方法 去 序列 化 cookie， 以 
及 如 何 将 这 些 序列 化 之 后 的 cookie 发 送 至 客户 端 。 











代码 清单 4-13 向 浏览 器 发 送 cookie 














package main 


import ( 
"net/http" 
) 


func setCookie(w http.ResponseWriter, r *http.Request) { 
c1 := http.Cookie{ 
Name: "first cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


= http.Cookief{ 

Name: "second_cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


w.Header().Set( "Set-Cookie", c1.String()) 
w.Header().Add("Set-Cookie", c2.String()) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set_cookie", setCookie) 
server.ListenAndServe() 





这 段 代码 首先 使 用 Set 方法 添加 第 一 个 cookie， 然 后 再 使 用 Add 77 
法 添加 第 二 个 cookie。 现 在 ， 打 开 浏 览 右 并 访问 
http://127.0.0.1:8080/set_cookie， 如 果 一 切 正 常 ， 你 将 在 浏览 器 的 Web 





Inspector (Hi Aas) 中 看 到 图 4-3 所 示 的 cookie。《 图 中 展示 的 是 Safari 浏 


览 右 附带 的 Web Inspector， 但 无 论 使 用 的 是 什么 浏览 器 ， 在 相应 工具 中 
看 到 的 cookie 和 这 里 展示 的 应 该 都 是 一 样 的 。) 





eee Web Inspector 一 127.0.0.1 一 set_cookie 
= 
© Ug >= 1 11.1ms 
Resources Timelines Debugger Console Inspect 
< @ Cookies 

<> set_cookie — 127.0.0.1 Name Value Domain Path Expires Size HTTP Secure 
© Cookies 一 127.0.0.1 second_cookie Manning Publication Co 127.0.0.1 / Session 358 v 

==] az 

E Local Storage — 127.0.0.1 first cookie Go Web Programming 127.0.0.1 / 

EH Session Storage 一 127.0.0.1 


Session 308 v 





图 4-3 ”使 用 Safari 浏 览 器 的 Web Inspector 查 看 之 前 设置 的 cookie 


除了 Set 方法 和 Add 方法 之 外 ，Go 语 言 还 提供 了 一 种 更 为 快捷 方便 
的 cookie 设 置 方法 ， 那 就 是 使 用 net/http 库 中 的 SetCookie 方法 。 作 
为 例子 ， 代 码 清 单 4-14 展 示 了 如 何 使 用 SetCookie 方法 实现 与 代码 清单 
4-13 相 同 的 设置 操作 ， 其 中 加 粗 展 示 的 部 分 就 是 修改 了 的 代码 。 








代码 清单 4-14 ”使 用 setCookie 方法 设置 cookie 





func setCookie(w http.ResponseWriter, r *http.Request) { 
c1 := http.Cookie{ 

Name: 

Value: 


HttpOnly: true, 


"first cookie", 
"Go Web Programming”, 


c2 := http.Cookie{ 


Name: "second_cookie", 
Value: "Manning Publications Co", 
HttpOnly: true, 

} 

http.SetCookie(w, &c1) 


http.SetCookie(w, &c2) 





这 两 种 cookie 设 置 方式 区 别 并 不 大 ， 唯 一 需要 注意 的 是 ， 在 使 
用 SetCookie 方法 设置 cookie 时 ， 传 递 给 方法 的 应 该 是 指向 Cookie 结 
构 的 指针 ， 而 不 是 Cookie 结构 本 身 。 


4.4.3 inl bias 3k cookie 


在 学 习 了 如 何 将 cookie 存 储 到 客户 端 之 后 ， 现 在 让 我 们 来 看 看 如 何 
从 客户 端 获 取 cookie， 代 码 清 单 4-15 展 示 了 这 一 操作 的 具体 实现 方法 。 





代码 清单 4-15 “从 请 求 的 首部 获取 cookie 








package main 


import ( 
"fmt" 
"net/http" 
) 


func setCookie(w http.ResponseWriter, r *http.Request) { 
c1 := http.Cookie{ 
Name: "first cookie", 
Value: "Go Web Programming”, 
HttpOnly: true, 


} 
c2 := http.Cookie{ 


Name: "second cookie", 
Value: "Manning Publications Co", 
HttpOnly: true, 
} 
http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 
} 


func getCookie(w http.ResponseWriter, r *http.Request) { 
h := r.Header[ "Cookie" ] 
fmt.Fprintln(w, h) 

} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 

http.HandleFunc("/set_cookie", setCookie) 
http.HandleFunc("/get_cookie", getCookie) 
server.ListenAndServe() 





在 重新 编译 并 且 重 新 启动 这 个 服务 器 之 后 ， 使 用 浏览 器 访问 
http://127.0.0.1:8080/get_cookie， 将 会 在 浏览 器 上 看 到 以 下 结 


[first cookie=Go Web Programming; second cookie=Manning Publications Co] 





语句 r.Header["Cookie"] 返回 了 一 个 切片 ， 这 个 切片 包含 了 一 个 
字符 串 ， 而 这 个 字符 串 又 包含 了 客户 端 发 送 的 任意 多 个 cookie。 如 果 用 





户 想 要 取得 单独 的 键 值 对 格式 的 cookie， 束 需要 自行 对 

r.Header["Cookie"] 返回 的 字符 串 进行 语法 分 析 。 不 过 Go 也 提供 了 
一 些 其 他 方法 ， 让 用 户 可 以 更 容易 地 获取 cookie， 代 码 清单 4-16 展 示 了 
1 


vv 





























代码 清 上 





4-16 ”使 用 Cookie 方法 和 Cookie 方法 














package main 


"net/http" 
) 


func setCookie(w http.ResponseWriter, r *http.Request) { 
c1 := http.Cookie{ 
Name: "first_cookie", 
Value: "Go Web Programming", 
HttpOnly: true, 


:= http.Cookief{ 

Name: "second_cookie", 

Value: "Manning Publications Co", 
HttpOnly: true, 


http.SetCookie(w, &c1) 
http.SetCookie(w, &c2) 
} 


func getCookie(w http.ResponseWriter, r *http.Request) { 
c1, err := r.Cookie("first_cookie") 


if err != nil { 
fmt.Fprintln(w, "Cannot get the first cookie") 
} 
cs := r.Cookies() 
fmt.Fprintln(w, c1) 
fmt.Fprintln(w, cs) 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/set cookie", setCookie) 
http.HandleFunc("/get cookie", getCookie) 
server.ListenAndServe() 





Go 语言 为 Request 结构 提供 了 一 个 Cookie 方法 ， 正 如 代码 清单 4- 
16 中 的 加 粗 行 所 示 ， 这 个 方法 可 以 获取 指定 名 字 的 cookie。 如 果 指 定 的 
cookie 不 存在 ， 那 么 方法 将 返回 一 个 错误 。 因 为 Cookie 方法 只 能 获取 
单个 cookie， 所 以 如 果 想 要 同时 获取 多 个 cookie， 束 需要 用 到 Request 
结构 的 Cookies 方法 : Cookies 方法 可 以 返回 一 个 包含 了 所 有 cookie 的 
切片 ， 这 个 切片 跟 访问 Header 字段 时 获取 的 切片 是 完全 相同 的 。 在 重 
新 编译 并 且 重 新 启动 服务 器 之 后 ， 访 问 http:/127.0.0.1:8080/get_cookie， 
浏览 器 将 显示 以 下 内 容 : 








first_cookie=Go Web Programming 
[first_cookie=Go Web Programming second_cookie=Manning Publications Co] 





因为 上 面 展示 的 代码 在 设置 cookie 时 并 没有 为 这 些 cookie 设 置 相应 
的 过 期 时 间 ， 所 以 它们 都 是 会 话 cookie。 为 了 证 明 这 一 点 ， 我 们 只 需要 
退出 并 重启 浏览 器 (注意 ， 不 要 只 关闭 浏览 器 的 标签 ， 一定 要 完全 退出 
浏览 嚣 才 可 以 )， 然 后 再 次 访问 http://127.0.0.1:8080/get_cookie， 就 会 发 
现 之 前 设置 的 cookie 已 经 消失 了 。 








4.4.4 ”使 用 cookie 实 现 闪 现 消 息 


本 书 的 第 2 章 曾 经 介绍 过 如 何 使 用 cookie 管 理 用 户 登录 会 话 ， 在 对 
cookie 有 了 更 多 了 解 之 后 ， 现 在 是 时 候 来 考虑 一 下 怎样 把 cookie 应 用 到 
更 多 地 方 了 。 


为 了 问 用 尸 报告 茶 个 动作 的 执行 情况 ， 应 用 程序 有 时 候 会 癌 用 户 展 
示 一 条 简短 的 通知 消 轧 ， 比 如 说 ， 如 果 一 个 用 户 答 试 在 论坛 上 发 表 一 篇 
帖子 ， 但 是 这 篇 帖子 因为 茶 种 原因 而 发 表 失 败 了 ， 那 么 论坛 应 该 问 这 个 











用 户 展示 一 条 帖子 发 布 失 败 的 消息 。 根 据 本 书 之 前 提 到 过 的 最 小 惊讶 原 
则 ， 这 种 通知 消 恕 应 该 出 现在 用 户 当 前 所 在 的 页 面 ， 但 是 在 通常 情况 
下 ， 用 户 在 访问 这 个 页 面 时 却 不 应 该 看 到 这 样 的 消息 。 因 此 ， 程 序 实际 
上 要 做 的 是 在 某 个 条 件 被 满足 时 ， 才 在 页 面 上 显示 一 条 临时 出 现 的 消 
居 ， 这 样 用 户 在 刷新 页 面 之 后 就 不 会 再 看 见 相同 的 消 恩 了 一 一 我 们 把 这 
种 临时 出 现 的 消息 称 为 内 现 消 息 (flash message) 。 























实现 内 现 消息 的 方法 有 很 多 种 ， 但 最 常用 的 方法 是 把 这 些 消息 存储 
在 页 面 刷新 时 就 会 被 移 除 的 会 话 cookie 里 面 ， 代 码 清单 4-17 展 示 了 如 何 
使 用 Go 语言 实现 这 一 方法 。 














代码 清 间 


证 


4-17 ”使 用 Go 的 cookie 实 现 闪 现 消 ， 




















package main 


import ( 
"encoding/base64" 
"fmt" 
"net/http" 
"time" 

) 


func setMessage(w http.ResponseWriter, r *http.Request) { 
msg := []byte("Hello World!") 
c := http.Cookie{ 
Name: "flash", 
Value: base64.URLEncoding.EncodeToString(msg) , 


http.SetCookie(w, &c) 


} 

func showMessage(w http.ResponseWriter, r *http.Request) { 
c, err := r.Cookie("flash") 
if err != nil { 


if err == http.ErrNoCookie { 
fmt.Fprintln(w, "No message found") 


} 
} else { 


rc := http.Cookie{ 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, @), 


} 
http.SetCookie(w, &rc) 
val, _ := base64.URLEncoding.DecodeString(c.Value) 


fmt.Fprintln(w, string(val)) 
} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 

http.HandleFunc("/set_message", setMessage) 
http.HandleFunc("/show_message", showMessage) 
server.ListenAndServe() 





这 段 代 码 创建 了 setMessage 和 showMessage 两 个 处 理 器 函数 ， 并 
分 别 把 它们 与 路 径 /set_message 以 及 /show_message 进行 绑 定 。 首 
先 ， 让 我 们 来 看 看 setMessage 函数 ， 它 的 定义 非常 简单 直接 ， 如 代码 
清单 4 一 18 所 示 。 








代码 清单 4-18 设置 消 


ct 











func setMessage(w http.ResponsewWriter, r *http.Request) { 
msg := []byte("Hello World!") 
http.Cookie{ 
Name: "flash", 
Value: base64.URLEncoding.EncodeToString(msg) , 


} 
http.SetCookie(w, &c) 





setMessage 处 理 器 函数 的 定义 跟 之 前 展示 过 的 setCookie 处 理 器 


函数 的 定义 非常 相似 ， 主 要 的 区 别 在 于 setMessage 对 消息 使 用 了 
Base64URL 编 码 ， 以 此 来 满足 啊 应 首部 对 cookie 值 的 URL 编 码 要 求 。 在 
设置 cookie 时 ， 如 果 cookie 的 值 没有 包含 诸如 空格 或 者 百 分 写 这 样 的 特 
殊 字 符 ， 那 么 不 对 它 进行 编码 也 是 可 以 的 ; 但 是 因为 在 发 送 闪 现 消 息 
时 ， 消 奶 本 里 通 常会 包含 诸如 空格 这 样 的 字符 ， 所 以 对 cookie 的 值 进行 
编码 就 成 了 一 件 必 不 可 少 的 事情 了 。 








现在 再 来 看 看 showMessage 函数 的 定义 : 


func showMessage(w http.ResponseWriter, r *http.Request) { 
c, err := r.Cookie("flash") 
if err != nil { 
if err == http.ErrNoCookie { 
fmt.Fprintln(w, "No message found") 


} 
} else { 
rc := http.Cookie{ 
Name: "flash", 
MaxAge: -1, 
Expires: time.Unix(1, @), 


http.SetCookie(w, &rc) 
val, _ := base64.URLEncoding.DecodeString(c.Value) 
fmt.Fprintlin(w, string(val) ) 





这 个 函数 首先 会 尝试 获取 指定 的 cookie， 如 果 没 有 找到 该 cookie， 
它 就 会 把 变量 err 设置 成 一 个 http.ErrNoCookie 值 ， 并 向 浏览 器 返回 
一 条 “No message found” 消 息 。 如 果 找 到 了 这 个 cookie， 那 么 它 必 须 完 
成 以 下 两 个 操作 : 


(1) 创建 一 个 同名 的 cookie， 将 它 的 MaxAge 值 设 置 为 负数 ， 并 且 


Expires 值 也 设置 成 一 个 已 经 过 去 的 时 间 ; 


(2) 使 用 setCookie 方法 将 刚刚 创建 的 同名 cookie 发 送 至 客户 


全 


ÙT o 


初 看 上 去 ， 这 两 个 操作 的 目的 似乎 是 要 蕉 换 已 经 存在 的 cookie， 但 
实际 上 ， 因 为 新 cookie 的 MaxAge 值 为 负数 ， 并 且 Expires 值 也 是 一 个 
已 经 过 去 的 时 间 ， 所 以 这 样 做 实际 上 就 是 要 完全 地 移 除 这 个 cookie。 在 
设置 完 新 cookie 之 后 ， 程 序 会 对 存储 在 旧 cookie 中 的 消息 进行 解码 ， 并 
通过 响应 返回 这 条 消息 。 


现在 ， 让 我 们 实际 运行 这 个 服务 器 ， 然 后 打开 浏览 器 并 访问 地 址 
http:Wlocalhost:8080/set_message。 如 果 一 切 顺利 ， 你 将 在 WebInspector 
中 看 到 图 4-4 所 示 的 cookie。 


OO Web Inspector — 127.0.0.1 — set_message 


O M Z o = © 


Resources Timelines Debugger Console 


Inspect 
< © Cookies 
<>) Set_message 一 127.0.0.1 OC Name Value Domain Path Expires Size HTTP Securi 
© Cookies 一 127.0.0.1 flash SGVsbG8gV29ybGQh 127.0.0.1 / Session 21B 


EB Local Storage 一 127.0.0.1 
E Session Storage 一 127.0.0.1 








图 4-4 在 Safari 浏 览 器 附带 的 WebInspector 中 查看 已 被 编码 的 闪现 消息 














注意 ， 因 为 图 中 cookie 的 值 已 经 被 Base64 URL 编 码 过 了 ， 所 以 它 初 
看 上 去 承 像 乱码 一 样 。 不 过 我 们 只 要 使 用 浏览 右 访 问 
http://localhost:8080/show_message， 就 可 以 看 到 解码 之 后 的 真正 的 消 


Hello World! 


il 


如 果 你 现在 再 去 看 WebInspector， 就 会 发 现 之 前 设置 的 cookie 已 经 
消失 了 : 通过 设置 同名 的 cookie， 程 序 成 功 地 使 用 新 cookie 代 替 了 旧 
cookie; 与 此 同时 ， 因 为 新 cookie 的 MaxAge 值 为 负数 ， 并 且 它 的 
Expires 值 也 是 一 个 已 经 过 去 的 时 间 ， 这 相当 于 命令 浏览 右 有 删除 这 个 
cookie， 所 以 这 个 新 设置 的 cookie 也 被 移 除了 。 





现在 ， 如 果 刷 新 网 页 ， 或 者 再 次 访问 
http:Wlocalhost:8080/show_message， 你 将 看 到 以 下 消息 : 


No message found 





本 章 沿 着 上 一 章 的 脚步 ， 介 绍 了 net/http 在 Web 应 用 开发 方面 提 
供 的 服务 器 端 功能 ， 而 接 下 来 的 一 章 将 对 Web 应 用 的 另 一 个 主要 组 成 部 
分 一 一 模板 一 一 进行 介绍 ， 我 们 将 会 了 解 到 Go 语言 的 模板 以 及 模板 引 
擎 ， 并 学 会 如 何 使 用 它们 为 客户 端 生 成 响应 。 


A574, 


Go 语言 提供 了 多 种 不 同 的 结构 ， 用 于 表示 HTTP 请 求 的 各 个 不 同 部 
分 ， 从 这 些 结构 里 面 可 以 提取 出 请 求 包 含 的 各 项 信息 。 

Request 结构 的 Form 、PostForm 和 MultipartForm 字段 可 以 让 
户 更 容易 地 提取 出 请 求 中 的 不 同 数据 : 用 户 只 要 调用 ParseForm 方 
法 或 者 ParseMultipartForm 方法 对 请 求 进行 语法 分 析 ， 然 后 访问 
相应 的 字段 ， 就 可 以 取得 请 求 中 包含 的 数据 。 

Form 字段 存储 的 是 来 自 URL 以 及 HTML 表 单 的 URL 编 码 数 据 ， 

Post 字段 存储 的 是 来 自 HTML 表 单 的 URL 编 码 数据 ， 而 
MultipartForm 字段 存储 的 则 是 来 自 URL 以 及 HTML 表 单 的 
multipart 编 码 数据 。 

服务 器 通过 向 ResponseWriter 写 入 首部 和 主体 来 向 客户 端 返回 响 
应 。 

通过 向 ResponseWriter 写 入 cookie， 服 务 器 可 以 将 数据 持久 地 存 
储 在 客户 端 上 。 

cookie 可 以 用 于 实现 内 现 消息 。 
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本 章 主要 内 容 


。 模板 以 及 模板 引擎 

。 Go 语言 的 模板 库 text/template 和 html/template 
。 模板 中 的 动作 、 管 道 以 及 函数 

。 网 套 的 模板 与 布局 


Web 模 板 就 是 一 些 预先 设计 好 的 HTML 页 面 ， 名 为 模板 引擎 的 软件 
程序 会 通过 重复 地 使 用 这 些 页 面 来 创建 一 个 或 多 个 HTML 页 面 。Web 模 
板 引 擎 是 Web 应 用 框架 的 重要 组 成 部 分 ， 绝 大 多 数 成 熟 的 框架 都 会 拥有 
相应 的 模板 引擎 ， 有 一 小 部 分 框架 的 模板 引擎 是 直接 构 入 框 染 里 面 的 ， 
而 其 他 绝 大 多 数 框架 都 允许 用 户 像 吃 目 助 餐 一 样 ， 根 据 上 自己 的 喜好 选择 
相应 的 模板 引擎 。 











Go 语言 也 不 例外 一 一 尽管 Go 还 是 一 门 相对 较 新 的 编程 语言 ， 但 已 
经 出 现 了 一 些 使 用 Go 语言 构建 的 模板 引擎 ， 除 此 之 外 ，Go 的 标准 库 也 
通过 text/template 和 html/template 这 两 个 库 为 模板 提供 了 强 有 力 
的 支持 ， 并 且 毫 不 意外 地 很 多 Go 框架 都 使 用 了 这 两 个 库 作 为 默认 的 模 
板 引 擎 。 


本 章 将 对 上 面 提 到 的 两 个 库 进 行 介绍 ， 并 说 明 如 何 使 用 它们 生成 
HTML 响 应 。 


51 模板 引擎 


如 图 5-1 所 示 ， 模 板 引 擎 通过 将 数据 和 模板 组 合 在 一 起 生成 最 终 的 
HTML， 而 处 理 堪 则 负责 调用 模板 引擎 并 将 引擎 生成 的 HIML 返 回 给 客 
户 端 。 


如 前 所 述 ，Web 模 板 引 擎 演变 自 SSI〈 服 务 器 端 包含 ) 技术 ， 并 最 
终 衍生 出 了 诸如 PHP、ColdFusion 和 JSP 这 样 的 Web 编程 语言 。 这 种 演变 
导致 的 一 个 结果 是 模板 引擎 并 没有 相应 的 标准 ， 并 且 对 各 个 因为 不 同 原 
因 创造 出 来 的 模板 引擎 来 说， 它们 拥有 的 特性 也 是 五 花 八 门 、 各 不 相同 
的 。 不 过 大 致 来 讲 ， 我 们 可 以 把 模板 引擎 划分 为 两 种 理想 的 类 型 ， 这 两 
种 类 型 的 模板 正好 处 于 两 个 极端 。 


图 5-1 模板 引擎 通过 组 合 数据 和 模板 来 生成 最 终 展示 的 HTML 


。 无 逻辑 模板 引擎 (logic-less template engine) 一 一 将 模板 中 指定 的 
占 位 符 蔡 换 成 相应 的 动态 数据 。 这 种 模板 引 苟 只 进行 字符 串 蔡 换 ， 











而 不 执行 任何 逻辑 处 理 。 无 逻辑 模板 引擎 的 目的 是 完全 分 离 程序 的 
表现 和 逻辑 ， 并 将 所 有 计算 方面 的 工作 都 交 给 处 理 器 完成 。 

由 入 逻辑 的 模板 引擎 (embedded logic template engine) 将 编程 
语言 代码 租 入 模板 当中 ， 并 在 模板 引 敬 演 染 模板 时 ， 由 模板 引 苟 执 
行 这 些 代 码 并 进行 相应 的 字符 串 蔡 换 工 作 。 因 为 拥有 在 模板 里 面 项 
入 逻辑 的 能 力 ， 所 以 这 类 模板 引擎 能 够 变 得 非常 强大 ， 但 与 此 同 
时 ， 这 种 能 力也 会 导致 多 辑 分 散 授 布 在 不 同 的 处 理 器 之 间 ， 使 代码 
变 得 难以 维护 。 











因为 不 需要 进行 逻辑 处 理 ， 所 以 无 逻辑 模板 引擎 的 泻 染 速 度 往往 会 
更 快 一 些 。 一 些 模板 引擎 虽然 自称 是 无 逻辑 模板 引擎 ， 但 它们 实际 上 并 
非 只 执行 字符 串 替 换 操作 。 比 如 ，Mustache 虽 然 自称 是 无 还 辑 模板 引 
擎 ， 但 它 实 际 上 也 提供 了 一 些 能 够 执行 条 件 判 断 操 作 和 循环 操作 的 标签 
(tag) 。 





另外 ， 最 极端 的 舱 入 逻辑 模板 引擎 通常 表现 得 跟 普 通 的 编程 语言 一 
样 ， 比 如 PHP 就 是 一 个 很 好 的 例子 : PHP 一 开始 是 作为 独立 的 Web 模 板 
引 敬 出现 的 ， 但 今 时 今日 的 很 多 PHP 页 面 已 经 很 难看 到 哪怕 一 行 HTML 
代码 ， 我 们 甚至 已 经 不 太 可 能 继续 把 PHP 看 作 是 一 个 模板 引擎 了 ， 实 际 
上 了 PHP 本身 就 拥有 很 多 模板 引擎 ， 比 如 ，Smarty 和 Blade 都 是 为 PHP 构 建 
的 。 




















对 于 奶 入 逻辑 模板 引擎 的 最 大 争论 ， 就 是 认为 它 把 表现 和 逻辑 搅 合 
在 了 一 起 ， 并 将 逻辑 分 散在 多 个 不 同 的 地 方 ， 导 致 代码 变 得 难以 维护 。 
而 对 于 无 逻辑 模板 引擎 的 第 论 则 是 认为 这 种 理想 化 的 模板 引擎 并 不 实 
用 ， 并 且 会 导致 处 理 需 需要 包 合 更 多 逻辑 ， 特 别 是 表现 方面 的 多 辑 ， 并 
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在 实际 中 ， 绝 大 多 数 有 用 的 模板 引擎 都 会 介 于 以 上 这 两 种 理想 的 模 
板 引 擎 之 间 ， 其 中 有 些 模板 引擎 更 接近 于 无 逻辑 模板 引擎 ， 而 其 他 一 些 
模板 引擎 则 更 接近 于 磐 入 馆 辑 模板 引擎。Go 标 准 库 提 供 的 模板 引擎 功 
能 大 部 分 都 定义 在 了 text/template 库 当 中 ， 而 小 部 分 与 HTML 相关 
的 功能 则 定义 在 了 html/template 库 里 面 。 这 两 个 库 相 辅 相 成 : 用 户 
可 以 把 这 个 模板 引擎 当做 无 逻辑 模板 引 敬 使用， 但 与 此 同时 ，Go 也 提 
供 了 足够 多 的 和 藤 入 式 模板 引擎 特性 ， 使 这 个 模板 引擎 用 起 来 既 有 趣 又 强 
Ke 





5.2 Go 的 模板 引擎 


跟 其 他 大 多 数 模板 引擎 一 样 ，Go 语 言 的 模板 引擎 也 是 介 于 无 逻辑 
模板 引 敬 和 和 众 入 轴 辑 模板 引擎 之 间 的 一 种 模板 引擎。 在 Web 应 用 里 面 ， 
模板 引擎 通常 由 处 理 器 负责 触发 。 作 为 例子 ， 图 5-2 展 示 了 处 理 器 调用 
Go 模板 引擎 的 流程 : 处 理 器 首先 调用 模板 引擎 ， 接 着 以 模板 文件 列表 
的 方式 向 模板 引擎 传 入 一 个 或 多 个 模板 ， 然 后 再 传 入 模板 需要 用 到 的 动 
态 数据 ;模板 引 擎 在 接收 到 这 些 参数 之 后 会 生成 出 相应 的 HIML， 并 将 
这 些 文件 写 入 到 ResponseWriter 里 面 ， 然 后 由 ResponseNriter 将 
HTTP 响 应 返回 给 客户 端 。 











图 5-2 ”Go 模板 引擎 在 Web 应 用 中 的 作用 示意 





Go 的 模板 都 是 文本 文档 (其 中 Web 应 用 的 模板 通常 都 是 HTML) ， 
它们 都 嵌入 了 一 些 称 为 动作 〈action) 的 指令 。 从 模板 引擎 的 角度 来 
说 ， 模 板 就 是 舱 入 了 动作 的 文本 “这 些 文 本 通常 包含 在 模板 文件 里 











面 ) ， 而 模板 引擎 则 通过 分 析 并 执行 这 些 文 本 来 生成 出 另外 一 些 文本 。 
Go 语言 拥有 通用 模板 引擎 库 text/template ， 它 可 以 处 理 任 意 格 式 的 
文本 ， 除 此 之 外 ，Go 语 言 还 拥有 专门 为 HIML 格 式 而 设 的 模板 引擎 库 
html/template 。 模 板 中 的 动作 默认 使 用 两 个 大 括号 {{ 和 }} 包围 ， 如 
末 用 户 有 需要 ， 也 可 以 通过 模板 引擎 提供 的 方法 自行 指定 其 他 定 界 符 
(delimiter) 。 本 草 稍 后 将 对 动作 做 更 详细 的 介绍 ， 在 此 之 前 ， 让 我 们 
先 来 看 一 下 代码 清单 5-1 展 示 的 这 个 非常 简单 的 模板 。 








代码 清单 5-1 一 个 简单 的 模板 





<!DOCTYPE html> 
<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 


<body> 
A.H 
</body> 
</html> 





代码 清单 5-1 展 示 的 模板 来 源 于 一 个 名 为 tmp1.html 的 模板 文件 。 
用 户 可 以 拥有 任意 多 个 模板 文件 ， 并 且 这 些 模板 文件 可 以 使 用 任意 后 绥 
名 ， 但 它们 的 类 型 必须 是 可 读 的 文本 格式 。 因 为 上 面 这 段 模板 的 输出 将 
古 一 个 HTML 文 件 ， 所 以 我 们 使 用 了 .html 作为 模板 文件 的 后 级 名 。 


注意 ， 模 板 中 被 两 个 大 括号 包围 的 点 〈. ) 是 一 个 动作 ， 它 指示 模 
板 引 擎 在 执行 模板 时 ， 使 用 一 个 值 去 谷 换 这 个 动作 本 身 。 





使 用 Go 的 web 模板 引擎 需要 以 下 两 个 步 又 : 





C1) 对 文本 格式 的 模板 源 进行 语法 分 析 ， 创 建 一 个 经 过 语法 分 析 
的 模板 结构 ， 其 中 模板 源 既 可 以 是 一 个 字符 串 ， 也 可 以 是 模板 文件 中 包 
SHAR: 


(2) 执行 经 过 语法 分 析 的 模板 ， 将 ResponseWriter 和 模板 所 需 
的 动态 数据 传递 给 模板 引擎 ， 被 调用 的 模板 引擎 会 把 经 过 语法 分 析 的 模 
板 和 传 入 的 数据 结合 起 来 ， 生 成 出 最 终 的 HIML， 并 将 这 些 HTML 传 递 


给 ResponseWriter 。 


代码 清单 5-2 展 示 了 一 个 简单 而 且 具 体 的 模板 引擎 使 用 例子 。 





























代码 清单 5-2 ”在 处 理 器 函数 中 触发 模板 引擎 

















package main 


import ( 
"net/http" 
"html/template" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, "Hello World!") 

} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 





代码 清单 5-2 展 示 的 服务 器 代码 跟 之 前 展示 过 的 服务 器 代码 非常 相 
似 ， 主 要 的 区 别 在 于 这 次 的 服务 器 使 用 了 一 个 名 为 process WALIE as eK 


数 ， 而 模板 引擎 就 是 由 这 个 函数 负责 触发 的 。process 函数 首先 使 

用 ParseFiles 函数 对 模板 文件 tmp1.html 进行 语法 分 

析 ，ParseFiles 函数 在 执行 完毕 之 后 将 返回 一 个 Template 类 型 的 已 
分 析 模 板 和 一 个 错误 作为 结果 ， 不 过 为 了 保持 代码 的 简洁 ， 我 们 这 里 暂 
时 把 这 个 错误 忽略 了 : 


t, _ := template.ParseFiles("tmpl.html") 





在 此 之 后 ，process 函数 会 调用 Execute 方法 ， 将 数据 应 用 
(apply〉 到 模板 里 面 一 一 在 这 个 例子 中 ， 数 据 就 是 字符 串 "Hello 
World!": 


t.Execute(w, "Hello World!") 


ResponseWriter 和 数据 会 一 起 被 传 入 Execute 方法 中 ， 这 样 一 
来 ， 模 板 引擎 在 生成 HTIML 之 后 就 可 以 把 该 HTML 传 给 
ResponseWriter 了 。 另 外 需要 注意 的 是 ， 因 为 这 个 服务 器 在 指定 模板 
位 置 时 并 没有 给 出 模板 文件 的 绝对 路 径 ， 所 以 我 们 在 运行 这 个 服务 器 的 
时 候 ， 需 要 把 模板 文件 和 服务 器 的 二 进 制 文件 放 到 同一 个 目录 里 面 。 








以 上 展示 的 就 是 模板 引擎 的 最 基本 用 法 ， 正 如 你 所 料 ， 除 了 . 之 
外 ，Go 的 模板 引擎 还 提供 了 其 他 动作 供用 户 使 用 ， 本 章 将 在 稍 后 的 内 
容 中 对 这 些 动作 做 进一步 的 介绍 。 


5.2.1 ”对 模板 进行 语法 分 析 





ParseFiles 是 一 个 独立 的 (standalone〉 函数 ， 它 可 以 对 模板 文件 
进行 语法 分 析 ， 并 创建 出 一 个 经 过 语法 分 析 的 模板 结构 以 供 Execute 方 
法 执行 。 实 际 上 ，ParseFiles KAR ÆN T AEH Template 结 
构 的 ParseFiles 方法 而 设置 的 一 个 函数 一 一 当 用 户 调 用 ParseFiles 

函数 的 时 候 ，Go 会 创建 一 个 新 的 模板 ， 并 将 用 户 给 定 的 模板 文件 的 名 
字 用 作 这 个 新 模板 的 名 字 : 





_ := template.ParseFiles("tmpl.html") 





这 相当 于 创建 一 个 新 模板 ， 然 后 调用 它 的 ParseFiles 方法 : 


template.New("tmpl.html") 
:= t.ParseFiles("tmpl.html") 





无 论 是 ParseFiles 函数 还 是 Template 结构 的 ParseFiles Wik, 
它们 都 可 以 接受 一 个 或 多 个 文件 名 作为 参数 ， 换 句 话 说 ， 这 两 个 函数 / 
方法 都 是 可 变 参 数 函 数 / 方 法 ， 它 们 可 以 接受 的 参数 数量 是 可 变 的 。 但 
io 无 论 这 两 个 函数 /方法 接受 多 少 个 文件 名 作为 输入 ， 它 们 都 





只 返回 一 个 模板 。 


当 用 户 向 ParseFiles 函数 或 ParseFiles 方法 传 入 多 个 文件 
IN, ParseFiles 只 会 返回 用 户 传 入 的 第 一 个 文件 的 已 分 析 模 板 ， 并 且 
这 个 模板 也 会 根据 用 户 传 入 的 第 一 个 文件 的 名 字 进 行 命名 ; 至 于 其 他 传 
入 文件 的 已 分 析 模 板 则 会 被 放置 到 一 个 映射 里 面 ， 这 个 映射 可 以 在 之 后 
执行 模板 时 使 用 。 换 句 话 说， 我们 可 以 这 样 认 为 : 在 问 ParseFiles fk 


入 单个 文件 时 ，ParseFiles 返回 的 是 一 个 模板 : 而 在 向 ParseFiles 
传 入 多 个 文件 时 ，ParseFiles 返回 的 则 是 一 个 模板 集合 ， 理 解 这 一 点 
能 够 帮助 我 们 更 好 地 学 习 本 章 稍 后 将 要 介绍 的 舱 套 模板 技术 。 








对 模板 文件 进行 语法 分 析 的 另 一 种 方法 是 使 用 ParseGlob 函数 ， 跟 
ParseFiles 只 会 对 给 定 文件 进行 语法 分 析 的 做 法 不 同 ，ParseGlob 会 
对 匹配 给 定 模 式 的 所 有 文件 进行 语法 分 析 。 举 个 例子 ， 如 果 目 录 里 面 只 
有 tmpl.html 一 个 HTML 文件 ， 那 么 语句 


t, _ := template.ParseFiles("tmpl.html1") 





和 语句 


t, _ := template.ParseGlob("*.html") 





将 产生 相同 的 效果 。 


在 绝 大 多 数 情况 下 ， 程 序 都 是 对 模板 文件 进行 语法 分 析 ， 但 是 在 需 
要 时 ， 程 序 也 可 以 直接 对 字符 串 形式 的 模板 进行 语法 分 析 。 实 际 上 ， 所 
有 对 模板 进行 语法 分 析 的 手段 最 终 都 需要 调用 Parse 方法 来 执行 实际 的 
语法 分 析 操 作 。 比 如 说 ， 在 模板 内 容 相同 的 情况 下 ， 语 句 





t, _ := template.ParseFiles("tmpl.html") 





和 代码 


tmpl := ~<!DOCTYPE html> 
<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 


</body> 
</html> 


:= template.New("tmpl.htm1") 
t, _ = t.Parse(tmpl) 
t.Execute(w, "Hello World!") 





将 产生 相同 的 效果 。 


到 目前 为 止 ， 本 章 一 直 都 没有 人 处理 分 析 模 板 时 可 能 会 产生 的 错误 。 
虽然 Go 语言 的 一 般 做 法 是 手动 地 处 理 错误 ， 但 Go 也 提供 了 另外 一 种 机 
制 ， 专 门 用 于 处 理 分 析 模 板 时 出 现 的 错误 : 


t := template.Must(template.ParseFiles("tmpl.html")) 








Must 函数 可 以 包 于 起 一 个 函数 ， 被 包 于 的 函数 会 返回 一 个 指 问 模 
板 的 指针 和 一 个 错误 ， 如 果 这 个 错误 不 是 nil ， 那 么 Must 函数 将 产生 
一 个 panic。“〈 在 Go 里 面 ，panic 会 导致 正常 的 执行 流程 被 终止 : 如果 
panic 是 在 函数 内 部 产生 的 ， 那 么 函数 会 将 这 个 panic 返 回 给 它 的 调用 
者 。panic 会 一 直 同 调用 栈 的 上 方 传递 ， 直 至 main 函数 为 止 ， 并 且 程 序 
也 会 因此 而 月 尝 。) 


5.2.2 ”执行 模板 





执行 模板 最 常用 的 方法 就 是 调用 模板 的 Execute DIS, FIVEN 
递 ResponseWriter 以 及 模板 所 需 的 数据 。 在 只 有 一 个 模板 的 情况 下 ， 
上 面 提 到 的 这 种 方法 总 是 可 行 的 ， 但 如 果 模 板 不 止 一 个 ， 那 么 当 对 模板 
合 调用 Execute 方法 的 时 候 ，Execute 方法 只 会 执行 模板 集合 中 的 第 
一 个 模板 。 如 果 想 要 执行 的 不 是 模板 集合 中 的 第 一 个 模板 而 是 其 他 模 
板 ， 就 需要 使 用 Execute Template 方 法 。 比 如 ， 对 以 下 语句 来 说 : 











t, _ := template.ParseFiles("t1.html", "t2.html") 





变量 t 就 是 一 个 包含 了 两 个 模板 的 模板 集合 ， 其 中 第 一 个 模板 名 

为 t1.html ， 而 第 二 个 模板 则 名 为 t2.html 〈 正 如 前 面 所 说 ， 除 非 显 式 
地 对 模板 名 进行 修改 ， 否 则 模板 的 名 字 和 后 缀 名 将 由 传 入 的 模板 文件 决 
定 ) 。 如 果 对 这 个 模板 集合 调用 Execute 方法 : 


t.Execute(w, "Hello World!") 


就 只 有 模板 t1.html 会 被 执行 。 如 果 想 要 执行 的 是 模板 t2 .html 而 不 
是 t1.html ， 则 需要 执行 以 下 语句 : 





t.ExecuteTemplate(w, "t2.html", "Hello World!") 





在 学 会 了 怎样 调用 模板 引擎 并 使 用 它 去 分 析 和 执行 模板 之 后 ， 接 下 
来 我 们 要 学 习 的 是 如 何 使 用 Go 语言 提供 的 各 种 模板 动作 。 


5.3 动作 


正如 之 前 所 说 ，Go 模 板 的 动作 就 是 一 些 验 入 在 模板 里 面 的 命令 ， 
这 些 命令 在 模板 中 使 用 两 个 大 括号 {{ 和 }} 进行 包围 。Go 拥 有 一 套 非常 
丰富 的 动作 集合 ， 它 们 不 仅 功 能 强大 ， 而 且 还 非常 灵活 多 变 。 本 市 将 讨 
沦 以 下 几 种 主要 的 动作 : 


条 件 动作 ; 
IRANI s 
设置 动作 ; 
包含 动作 。 





除了 以 上 4 种 动作 之 外 ， de 外 一 种 重要 的 动作 
一 一 定义 动作 。 如 果 读 者 对 其 他 类 型 的 动作 也 感 兴趣 ， 那 么 可 以 参 
考 text/template 库 的 文档 。 


里 然 初 看 上 去 可 能 会 让 人 感到 惊讶 ， 但 其 实 抬 (. ) 也 是 一 个 动 
作 ， 并 且 是 最 为 重要 的 一 个 ， 它 代表 的 是 传递 给 模板 的 数据 ， 其 他 动作 
和 函数 基本 上 痢 会 对 这 个 动作 进行 处 理 ， 以 此 来 达到 格式 化 和 内 容 展示 
的 目的 。 


5.3.1 条 件 动 作 


条 件 动作 会 根据 参数 的 值 来 决定 对 多 条 语句 中 的 哪 一 条 语句 进行 求 
值 。 最 简单 的 条 件 动作 的 格式 如 下 : 


{{ if arg }} 





some content 
{{ end }} 


这 个 动作 的 男 一 种 格式 如 下 : 


{{ if arg }} 


some content 


{{ else }} 


other content 


{{ end }} 








以 上 两 种 格式 中 的 arg 都 是 传递 给 条 件 动作 的 参数 。 本 章 稍 后 会 对 
动作 的 参数 做 更 详细 的 介绍 ， 目 前 来 说 ， 我 们 可 以 把 参数 看 作 是 一 个 
值 ， 这 个 值 可 以 是 一 个 字符 串 常量 、 一 个 变量 、 一 个 返回 单个 值 的 函数 
或 者 方法 ， 诸 如 此 类 。 现 在 ， 让 我 们 来 看 一 下 如 何在 模板 中 使 用 这 个 条 
件 动作 。 如 代码 清单 5-3 所 示 ， 我 们 会 在 服务 器 上 面 创建 一 个 处 理 器 ， 
这 个 处 理 器 会 随机 地 生成 介 于 0 至 10 之 间 的 随机 整数 ， 然 后 通过 判断 这 
个 随机 整数 是 否 大 于 5 来 创建 出 一 个 布尔 值 ， 并 在 最 后 将 这 个 布尔 值 传 
递 给 模板 。 























gun} 





代码 清单 5-3 ”在 处 理 器 里 面 生成 一 个 随机 数 





























package main 


import ( 
"net/http" 
"html/template" 
"math/rand" 
"time" 


) 


func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 


rand.Seed(time.Now().Unix()) 
t.Execute(w, rand.Intn(1@) > 5) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 


} 





在 此 之 后 ， 我 们 需要 在 模板 文件 tmpl.html 里 面 对 传 入 的 参数 进行 
测试 ， 并 根据 测试 的 结果 ， 在 页 面 上 显示 “Number is greater than 5! 
”和 “Number is 5 or less! ”这 两 条 消息 中 的 一 条 ， 具 体 的 做 法 如 代码 清单 
5-4 所 示 。【〔 正 如 之 前 所 说 ， 动 作 . 代表 的 是 处 理 器 传递 给 模板 的 数据 ， 
在 这 个 例子 中 ，. 代表 的 是 被 传 入 的 布尔 值 。) 








代码 清单 5-4 ”使 用 了 条 件 动作 的 模板 文件 tmp1 .html 





<!DOCTYPE html> 
<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
{{ if . }} 


Number is greater than 5! 
{{ else }} 
Number is 5 or less! 
{{ end }} 
</body> 
</html> 





5.3.2 ”迭代 动作 


KAREN DAT A WA RCE TIAN, FETE AA 
HHAH, A C) WARE AS HBR Toa, MAAF: 


{{ range array }} 
Dot is set to the element {{ . }} 


{{ end }} 





Ws HS -S HR aN AMEE CSTE BS -o 





代码 清单 5-5 RIERA 








<!DOCTYPE html> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<ul> 
{{ range . }} 
<li>{{ . }}</li> 
{{ end}} 
</ul> 
</body> 
</html> 








P EI ee fA TA VA 1k SA A Ae EE A : 


func process(w http.ResponsewWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
daysOfWeek := []string{"Mon", "Tue", "Wed", "Thu", "Fri", " 


t.Execute(w, daysOfWeek ) 





这 段 代 码 创建 了 一 个 切片 ， 并 在 切片 里 面包 含 了 周一 到 周 日 的 英文 
缩写 ， 然 后 将 它 传递 给 模板 。 接 着 ， 这 个 切片 会 被 传递 至 语句 {{ 
range . })} 中 的 . 里 面 ， 然 后 由 range 动作 对 这 个 切片 中 的 各 个 元 素 
进行 迭代 。 

迭代 循环 中 的 {{ . H 代表 的 是 当前 被 迭代 的 切片 元 素 ， 图 5-3 展 
示 了 浏览 器 展示 的 迭代 结果 。 


eee 127.0.0.1:8080/process 4 由 

















图 5-3 EEC ESB 
代码 清单 5-6 展 示 了 迭代 动作 的 一 个 变种 ， 这 个 变种 允许 用 户 在 被 
迭代 的 数据 结构 为 空 时 ， 显 示 一 个 备 选 的 〈fallback) 结 


代码 清单 5-6 ” 带 有 备 选 结果 的 迭代 动作 





<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<ul> 


{{ range . }} 


<li>{{ . }}</li> 
{{ else }} 
<li> Nothing to show </li> 
{{ end}} 
</ul> 
</body> 
</html> 





模板 里 面 介 于 {{ else }} 和 {{ end }}+ 之 间 的 内 容 将 在 点 〈. ) 
Anil 时 显示 。 在 这 个 例子 中 ， 被 显示 的 将 是 文本 “Nothing to show”. 


5.3.3 ”设置 动作 


设置 动作 允许 用 户 在 指定 的 范围 之 内 为 点 〈. ) 设置 值 。 比 如 ， 在 
以 下 代码 中 : 


{{ with arg }} 
Dot is set to arg 


{{ end }} 





介 于 {{ with arg }} 和 {{ end }} 之 间 的 点 将 被 设置 为 参数 arg 的 
值 。 再 次 修改 的 tmpl.html 文件 如 代码 清单 5-7 所 示 ， 这 是 一 个 更 为 具 
体 的 例子 。 





代码 清单 5-7 对 点 进行 设置 








<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>The dot is {{ . }}</div> 
<div> 
{{ with "world"}} 
Now the dot is set to {{ . }} 
{{ end }} 
</div> 
<div>The dot is {{ . }} again</div> 
</body> 
</html> 





至 于 调用 这 个 模板 的 处 理 器 则 会 将 字符 串 "hello" 传递 给 模板 : 


func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w,"hello") 


} 





这 样 一 来 ， 位 于 {{ with "world”}} 之 前 的 点 就 会 因为 处 理 器 传 入 的 
值 而 被 设置 成 hello ， 而 位 于 {{ with "world”}} 和 {{ end }} 之 

间 的 点 则 会 被 设置 成 world ; 但 是 ， 在 语句 {{ end }} 执行 完毕 之 后 ， 

点 的 值 又 会 重新 被 设置 成 hello ， 如 图 5-4 所 示 。 


eee < 127.0.0.1:8080/process Č 由 


The dot is hello 






The dot is hello again 














图 5-4 ”使 用 设置 动作 对 点 〈. ) 进行 设置 


跟 迄 代 动 作 一 样 ， 设 置 动作 也 拥有 一 个 能 够 提供 备 选 方 案 的 变种 : 


{{ with arg }} 
Dot is set to arg 


{{ else }} 


Fallback if arg is empty 
{{ end }} 





代码 清单 5-8 展 示 了 这 一 变种 的 使 用 方法 。 


代码 清单 5-8 在 设置 点 的 时 候 提供 备 选 方案 








<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 


</head> 
<body> 
<div>The dot is {{ . }}</div> 
<div> 
{{ with "" }} 
Now the dot is set to {{ . }} 
{{ else }} 
The dot is still {{ . }} 
{{ end }} 
</div> 
<div>The dot is {{ . }} again</div> 
</body> 
</html> 





因为 传 给 with 动作 的 参数 为 空 字符 串 "" ， 所 以 模板 将 显示 {{ 
else }} 语句 之 后 的 内 容 ， 此 外 ， 因 为 with 动作 并 没有 修改 点 〈. ) 
的 值 ， 所 以 模板 打印 出 来 的 仍然 是 处 理 器 传 入 的 值 "hello”。 执 行 这 个 
新 模板 不 需要 对 处 理 器 或 者 服务 器 进行 任何 修改 ， 也 不 需要 重启 服务 
器 ， 只 要 刷新 一 下 浏览 器 ， 就 会 看 到 图 5-5 所 示 的 结果 。 


eee < 127.0.0.1:8080/process Č 由 


The dot is hello 






The dot is hello again 


图 5-5 在 设置 点 〈. ) 时 提供 备 选 方案 





5.3.4 包含 动作 


包含 动作 Cinclude action) 允许 用 户 在 一 个 模板 里 面包 含 另 一 个 模 
板 ， 从 而 构建 出 租 套 的 模板 。 包 含 动作 的 格式 为 {{ template "name" 
}} ， 其 中 name 参数 为 被 包含 模板 的 名 字 。 


代码 清单 5-9 展 示 了 一 个 使 用 包含 动作 的 例子 ， 在 这 个 例子 中 ， 模 
板 t1.html 包含 了 模板 t2.html 。 


代码 清单 5-9 ”模板 t1.html 








<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 


<meta http-equiv="X-UA-Compatible" content="IE=9"> 
<title>Go Web Programming</title> 

</head> 

<body> 
<div> This is ti.html before</div> 
<div>This is the value of the dot in ti.html - [{{ . }}]</div> 
<hr/> 
{{ template "t2.html" }} 
<hr/> 
<div> This is t1.html after</div> 

</body> 

</html> 





正如 代码 所 示 ， 模 板 文件 的 名 字 将 被 用 作 模 板 的 名 字 。 记 住 ， 如 果 








用 户 在 创建 模板 的 时 候 没有 为 模板 指定 名 字 ， 那 么 Go 语言 在 命名 模板 
时 将 沿用 模板 文件 的 名 字 及 扩展 名 。 





代码 清单 5-10 展 示 了 被 包含 的 模板 t2.html ， 这 个 模板 是 一 上 段 
HTML 代 人 码 片 段 。 























代码 清单 5-10 ”模版 t2.html 





<div style="background-color: yellow;"> 
This is t2.html<br/> 
This is the value of the dot in t2.html - [{{ . }}] 


</div> 








代码 清单 5-11 展 示 了 使 用 以 上 两 个 模板 的 处 理 融 。 

















代码 清单 5-11 ”调用 髓 套 模板 的 处 理 器 














func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("t1.html", "t2.html") 
t.Execute(w, "Hello World!") 


} 


pO 


IRZ HANNS AA], FET REI, BAT OT YT 
FARRAR SCP ABIES TEA DT 0 FRU Ae EAER, EY 
模板 文件 进行 语法 分 析 将 导致 程序 出 现 不 正确 的 结果 。 





因为 上 面 的 代码 并 没有 为 模板 设置 名 字 ， 所 以 模板 集合 中 的 模板 将 
沿用 模板 文件 的 名 字 。 正 如 之 前 所 说 ，ParseFiles 函数 的 第 一 个 参数 
是 具有 特殊 作用 的 : 在 进行 语法 分 析 时 ， 用 户 给 定 的 第 一 个 模板 文件 将 
成 为 主 模 板 (main template) ， 当 用 户 对 模板 集合 调用 Execute 方法 
时 ， 主 模板 将 被 执行 。 





图 5-6 展 示 了 服务 器 在 执行 上 述 模板 之 后 同 浏 览 右 返回 的 结果 。 


如 图 5-6 所 示 ， 模 板 t1.html 中 的 点 〈. ) 被 传 入 的 "Hello 
World!" 准确 无 误 地 替换 掉 了 ， 并 且 模 板 t2.html 的 内 容 也 出 现在 了 语 
AJ{{ template "t2.html" }} 所 在 的 位 置 。 因 为 模板 t1.html 并 没 
有 把 字符 串 "Hello World!" 也 传递 给 被 髓 套 的 模板 t2.html ， 所 以 
t2.html 中 的 点 的 打印 结果 为 空 字符 串 。 为 了 向 被 拣 套 的 模板 传递 数 
据 ， 用 户 可 以 使 用 包含 动作 的 变种 {{ template "name" arg }}， 其 
中 arg 就 是 用 户 想 要 传递 给 被 髓 套 模 板 的 数据 ， 代 码 清 单 5-12 展 示 了 这 
个 变种 的 具体 使 用 方法 。 


@ee < 127.0.0.1:8080/process : A 


This is t1.html before 
This is the value of the dot in t1.html - [Hello World!] 


This is tl html after 





图 5-6 KÆRI IJIH R 








代码 清单 5-12 ”通过 参数 将 模板 t1.html P HANE A A RE A 2. htm 











<html> 

<head> 
<meta charset="utf-8"> 
<meta http-equiv="X-UA-Compatible" content="IE=9"> 
<title>Go Web Programming</title> 

</head> 

<body> 
<div> This is t1i.html before</div> 


<div>This is the value of the dot in t1.html - [{{ . }}]</div> 
<hr/> 
{{ template "t2.html" . }} 
<hr/> 
<div> This is t1.html after</div> 
</body> 
</html> 





这 个 模板 唯一 的 改动 就 是 在 t1.html 里 面 将 点 传递 给 了 t2.html 。 


现在 ， 如 末 我 们 再 次 执行 这 个 模板 ， 它 将 产生 图 5-7 所 示 的 结 


@ee < 127.0.0.1:8080/process , 由 + 
| 


This is tl html before 
This is the value of the dot in tl .html - [Hello World!] 


This is tl .html after 


图 5-7 RHEE BLK EH AK 





AS eA FRG VK EL ERR, FPS IAEA HP RRs 
{E—iE MBIVE) ROA TEA SITE AT WAZA RE RTT TE, (EE AST SP A 
的 都 是 初级 的 模板 用 法 ， 它 们 并 不 能 最 大 限度 地 友 挥 模板 的 威力 。 为 了 


解决 这 个 问题 ， 本 章 接 下 来 将 介绍 参数 、 变 量 和 管道 等 高 级 模板 用 法 。 








5.4” 参数、 变量 和 管道 


一 个 参数 (argument) 束 是 模板 中 的 一 个 值 。 它 可 以 是 布尔 值 、 整 
数 、 字 符 串 等 字面 量 ， 也 可 以 是 结构 、 结 构 中 的 一 个 字段 或 者 数组 中 的 
一 个 键 。 除 此 之 外 ， 参 数 还 可 以 是 一 个 变量 、 一 个 方法 〈 这 个 方法 必须 
只 返回 一 个 值 ， 或 者 只 返回 一 个 值 和 一 个 错误 ) 或 者 一 个 函数 。 最 后 ， 
参数 也 可 以 是 一 个 点 〈. ) ， 用 于 表示 处 理 絮 站 模板 引 敬 传递 的 数据 。 





比如 说 ， 在 以 下 这 个 例子 中 ，arg 是 一 个 参数 : 


{{ if arg }} 


some content 


{{ end }} 





BRS BBCI, FPA ESE ee. AERIS 
C$) FRI, WIRE: 


gvariable := value 


初 看 上 去 ， 变 量 似乎 并 没有 什么 特别 大 的 用 处 ， 但 实际 上 它们 对 动 
作 来 说 是 非常 重要 的 。 作 为 例子 ， 以 下 代码 展示 了 怎样 使 用 变量 去 实现 
友 代 动作 的 一 个 变种 ; 














{{ range $key, $value := . }} 
The key is {{ $key }} and the value is {{ $value }} 


{{ end }} 





在 这 个 例子 中 ， 点 〈. ) 是 一 个 映射 ， 而 动作 range FERC THR 
射 的 时 候 ， 会 将 变量 $key 和 $value 分 别 初始 化 为 当前 被 迭代 映射 元 素 
的 键 和 值 。 


模板 中 的 管道 〈pipeline) 是 多 个 有 序 地 串联 起 来 的 参数 、 函 数 和 
方法 ， 它 的 工作 方式 和 语法 跟 Unix 的 管道 也 非常 相似 : 


{{ pl | p2 | p3 }} 


这 里 的 pl1 p2 和 p3 可 以 是 参数 或 者 函数 。 管 道人 允许 用 户 将 一 个 参 
数 的 输出 传递 给 下 一 个 参数 ， 而 各 个 参数 之 间 则 使 用 | 分 隔 。 代 人 码 清单 
5-13 展 示 了 一 个 管道 的 使 用 示例 。 














代码 清 上 











5-13 ”模板 中 的 管道 




















<!DOCTYPE html> 
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
{{ 12.3456 | printf "%.2f" }} 


</body> 
</html> 

















为 了 更 好 地 显示 内 容 ， 用 户 经 常 需要 在 模板 中 对 数据 进行 格式 化 。 
比如 ， 在 代码 清单 5-13 所 示 的 例子 中 ， 我 们 想 要 在 显示 浮 点 数 的 时 候 只 
保留 两 位 小 数 精度 。 为 了 做 到 这 一 点 ， 我 们 可 以 使 用 fmt.Sprintf K 
数 或 者 模板 内 置 的 printf 函数 对 浮 点 数 进行 格式 化 (这 个 printf 函数 


实际 上 就 是 fmt.Sprintf 函数 的 别名 ) 。 


除 此 之 外 ， 我 们 还 通过 管道 将 数字 12.3456 传递 给 了 printf K 
数 ， 并 在 printf 函数 的 第 一 个 参数 中 指定 了 格式 指示 符 (specifier) ， 
最 终 ， 这 个 管道 将 返回 12.35 作为 结 


虽然 管道 已 经 非常 强大 ， 但 它 还 不 是 模板 提供 的 最 为 强大 的 功能 ， 
接 下 来 的 一 市 要 介绍 的 函数 才 是 。 


5.5 AŽ 


正如 之 前 所 说 ，Go 函 数 也 可 以 用 作 模 板 的 参数 :Go 模板 引擎 内 置 
了 一 些 非常 基础 的 函数 ， 其 中 包括 为 fmt.Sprint 的 不 同 变种 创建 的 几 

个 别名 函数 《〈fmt 包 的 文档 详细 地 列 出 了 这 些 别 名 函数 ) ， 并 且 用 户 不 
Oe 擎 内 置 的 函数 ， 还 可 以 自行 定义 自己 想 要 的 函数 。 





需要 注意 的 是 ，Go 的 模板 引 敬 函数 痢 是 受 限 制 的 ， 尽 浓 这些 函数 
可 以 接受 任意 多 个 参数 作为 输入 ， 但 它们 只 能 返回 一 个 值 ， 或 者 返回 一 
个 值 和 一 个 错误 。 





为 了 创建 一 个 目 定 义 模 板 函 数 ， 用 户 需 要 : 


(1) 创建 一 个 名 为 FuncMap 的 映射 ， 并 将 映射 的 键 设 置 为 函数 的 
名 字 ， 而 映射 的 值 则 设置 为 实际 定义 的 函数 ; 


(2) 将 FuncMap 与 模板 进行 绑 定 。 


让 我 们 来 看 一 个 创建 自 定义 函数 的 具体 例子 。 在 编写 Web 应 用 的 时 
候 ， 用 户 第 第 需要 将 时 间 对 象 或 者 日 期 对 象 转换 为 ISO8601 格 式 的 时 间 
字符 串 或 者 日 期 字符 串 ， 又 或 者 将 ISO8601 格 式 的 字符 串 转 换 为 相应 的 
对 象 。 但 遗憾 的 是 ， 我 们 正在 使 用 的 库 并 没有 内 置 类 似 的 转换 函数 ， 所 
以 我 们 就 需要 像 代码 清单 5-14 展 示 的 那样 ， 自 行 创建 这 些 函 数 。 





代码 清单 5-14 ”创建 模板 自 定义 函数 


package main 





import ( 
"net/http" 
"html/template" 
"time" 


) 


func formatDate(t time.Time) string { 
layout := "2006-01-02" 
return t.Format (layout) 

} 


func process(w http.ResponsewWriter, r *http.Request) { 
funcMap := template.FuncMap { "fdate": formatDate } 
t := template.New("tmpl.htm1").Funcs(funcMap) 
t, _ = t.ParseFiles("tmpl.html") 
t.Execute(w, time.Now()) 

} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 
http.HandleFunc("/process", process) 
server.ListenAndServe() 


} 





这 上段 程序 首先 定义 了 一 个 名 为 formatDate 的 函数 ， 它 接受 一 
个 Time 结构 作为 输入 ， 然 后 以 “年 -月 -日 ”的 形式 返回 一 个 ISO8601 格 式 
的 字符 串 。 


在 之 后 的 处 理 器 中 ， 程 序 创建 了 一 个 变量 名 为 funcMap 的 FuncMap 
结构 ， 并 使 用 这 个 结构 将 名 字 fdate 映射 至 formatDate 函数 。 接 着 ， 
程序 使 用 template.New 函数 创建 了 一 个 名 为 tmp1.html 的 模板 。 因 

为 template.New 冰 数 会 返回 被 创建 的 模板 ， 所 以 程序 直接 以 串联 的 方 

式 调用 模板 的 Funcs 方法 ， 并 将 前 面 创建 的 funcMap 传递 给 模板 。 这 样 
一 来 ，funcMap 与 模板 的 绑 定 就 完成 了 ， 于 是 程序 接 下 来 就 跟 往 常 一 





样 ， 对 模板 文件 tmp1.html 进行 语法 分 析 。 最 后 ， 程 序 调用 模板 的 
Execute 方法 ， 并 将 ResponseWriter 以 及 当前 时 间 传 递 给 它 


再 次 提醒 ， 在 调用 ParseFiles 函数 时 ， 如 果 用 户 没 有 为 模板 文件 
中 的 模板 定义 名 字 ， 那 么 函数 将 使 用 模板 文件 的 名 字 作 为 模板 的 名 字 。 
与 此 同时 ， 在 调用 New 函数 创建 新 模板 的 时 候 ， 用 户 必须 传 入 一 个 模板 
名 字 ， 如 果 用 户 给 定 的 模板 名 字 跟 前 面 分 析 模 板 时 通过 文件 名 提取 的 模 
板 名 字 不 相同 ， 那 么 程序 将 返回 一 个 错误 。 





在 看 过 了 处 理 器 的 相关 代码 之 后 ， 现 在 让 我 们 来 看 看 如 何 
在 tmpl.html 模板 中 使 用 前 面 定义 的 函数 ， 具 体 的 方法 如 代码 清单 5-15 
所 示 。 














代码 清单 5-15 ”通过 管道 使 用 自 定义 函数 




















<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 


<body> 
<div>The date/time is {{ . | fdate }}</div> 


</body> 
</html> 
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@ee < 127.0.0.1:8080/process 4 由 


The date/time is 2015-02-08 


图 5-8 ”使 用 自 定义 函数 格式 化 日 期 或 时 间 











除 此 之 外 ， 我 们 也 可 以 像 调用 普通 函数 一 样 ， 将 点 〈. ) 作为 参数 
传递 给 fdate 函数 ， 具 体 做 法 如 代码 清单 5-16 所 示 。 


代码 清单 5-16 ”通过 传递 参数 的 方式 使 用 自 定义 函数 


<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 


<body> 
<div>The date/time is {{ fdate . }}</div> 
</body> 
</html> 





DAE pat iid Ay esr" Ae PATRI 25 A BEH EE e EE H K BC 
ee 如 果 用 户 定 义 了 多 个 函数 ， 那 么 他 就 可 以 通过 管道 
将 一 cs 数 作为 输入 ， 从 而 以 不 同 的 方式 组 合 
a PRL; 尽管 普通 的 函数 调用 也 能 够 做 到 这 一 点 ， 但 使 用 管道 可 


以 产生 更 简单 且 更 可 读 的 代码 。 


5.6 上下文 感知 


Go 语言 的 模板 引擎 拥有 一 个 非常 有 趣 的 特性 一 一 它 可 以 根据 内 容 
所 处 的 上 下 文 改 变 其 显示 的 内 容 。 是 的 ， 你 没 看 错 。 根 据 内 容 在 文档 中 
所 处 的 位 置 ， 模 板 在 显示 这 些 内 容 的 时 候 将 对 其 进行 相应 的 修改 ， 换 名 
话说 ，Go 的 模板 将 以 上 下 文 感知 Ccontext-aware) 的 方式 显示 内 容 。 那 
么 这 个 特性 有 什么 用 ， 我 们 又 会 在 什么 地 方 用 到 这 个 特性 呢 ? 











上 下 文 感知 的 一 个 显而易见 的 用 途 就 是 对 被 显示 的 内 容 实 施 正确 的 
转 义 Cescape) : 这 意味 着 ， 如 果 模 板 显示 的 是 HTML 格 式 的 内 容 ， 那 
么 模板 将 对 其 实施 HTML 转 义 ; 如 果 模 板 显示 的 是 JavaScript 格 式 的 内 
容 ， 那 么 模板 将 对 其 实施 JavaScript 转 义 ; 诸如 此 类 。 除 此 之 外 ，Go 模 
板 引 擎 还 可 以 识别 出 内 容 中 的 URL 或 者 CSS 样 式 。 代 码 清单 5-17 展 示 了 
一 个 上 下 文 感知 特性 的 使 用 例子 。 
























































代码 清单 5-17 为 了 展示 模板 中 的 上 下 文 感知 特性 而 设置 的 处 理 器 














package main 


import ( 
"net/http" 
"html/template" 
) 
func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
content := `I asked: <i>"What's up?"</i> 


t.Execute(w, content) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
server.ListenAndServe() 





这 个 处 理 器 向 模板 发 送 了 文本 字符 串 I_ asked: <i>"What's up?" 
</i> ， 它 包含 了 几 个 需要 事先 转 义 的 特殊 字符 ， 代 码 清单 5-18 展 示 了 
与 这 个 处 理 器 相对 应 的 模板 文件 tmp1.html 。 




















代码 清单 5-18 上下文 感知 模板 








<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>{{ . }}</div> 
<div><a href="/{{ . }}">Path</a></div> 
<div><a href="/?q={{ . }}">Query</a></div> 
<div><a onclick="F('{{ . }}')">Onclick</a></div> 
</body> 
</html> 





正如 代码 所 示 ， 这 个 模板 将 传 入 的 参数 放 到 了 HTML 中 的 多 个 不 同 
的 位 置 ， 并 且 每 个 位 置 都 使 用 了 <div> 标签 对 其 进行 包 庄 。 如 果 我 们 使 
用 4.1.4 节 介绍 的 方法 ， 通 过 cURL 获取 未 经 改动 的 原始 HTML 文 件 ， 那 
么 我 们 将 得 到 以 下 结果 : 








curl -i 127.0.0.1:8080/process 
HTTP/1.1 200 OK 

Date: Sat, 07 Feb 2015 05:42:41 GMT 
Content-Length: 505 

Content-Type: text/html; charset=utf-8 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<div>I asked: &1t;i&gt; &#34;What&#39;s up?&#34;&1t;/i&gt;</div> 
<div> 
<a href="/1%20asked :%20%3 cizx3e%22What%27 s%20up 2%22%3c/1i%3e" > 
Path 
</a> 
</div> 
<div> 
<a href="/?q=I1%20asked%3a%20%3ci%3e%22What%27s%20up%3f%22%3c%2fi%3e" 


Query 
</a> 
</div> 
<div> 
<a onclick="f('I asked: \x3ci\x3e\x22What\x27s up?\x22\x3c\/i\x3e')" 


Onclick 
</a> 
</div> 
</body> 
</html> 





y 


这 个 结果 看 上 去 有 点 儿 复 杂 ， 表 5-1 展 示 了 结果 HTML 与 输入 原文 之 
间 的 区 别 。 





表 5-1 Go 模板 中 的 上 下 文 感知 : 根据 动作 所 在 的 位 置 ， 同 样 的 内 容 输入 将 产生 不 同 的 输出 结 


























I asked: <i>"What's up?"</i> 





{{ . }} I asked: &1t;i&gt; &#34;What&#39;s up?&#34;&1t; /i&gt; 


<a href="/{{ . }}"> I%20asked : %20%3ci%3e%22What%27s%20up ?%22%3c/1i%3e 


<a href="/?q={{ . }}"> I%20asked%3a%20%3ci%3e%22What%27s%20up%3f%22%3c%2fi%3e 





<a onclick="{{ . }}"> I asked: \x3ci\x3e\x22What\x27s up?\x22\x3c\/i\x3e 


上 下 文 感知 特性 主要 用 于 实现 目 动 的 防御 编程 ， 并 且 它 使 用 起 来 非 





党 方便 。 通 过 根据 上 下 文 对 内 容 进行 修改 ，Go 模 板 可 以 防止 某 些 明显 
并 且 低 级 的 编程 错误 。 比 如 ， 接 下 来 的 内 容 束 会 同 我 们 展示 如 何 使 用 上 
下 文 感知 特性 来 防御 XSS (cross-site scripting， 跨 站 脚本 ) 攻击。 


5.6.1 ”防御 XSS 攻 击 


持久 性 XSS 漏 洞 (persistent XSS vulnerability) 是 一 种 常见 的 XSS 攻 
击 方式 ， 这 种 攻击 是 由 于 服务 器 将 攻击 者 存储 的 数据 原原本本 地 显示 给 
其 他 用 户 所 致 的 。 举 个 例子 ， 如 果 有 一 个 存在 持久 性 XSS 漏 洞 的 论坛 ， 
它 允 许 用 户 在 论坛 上 面 发 布 帖子 或 者 回复 ， 并 且 其 他 用 户 也 可 以 阅读 这 
些 帖 子 以 及 回复 ， 那 么 攻击 者 就 可 能 会 在 他 发 布 的 内 容 中 引入 市 
A<script> 标签 的 代码 。 因 为 论坛 即使 在 内 容 带 有 <script> 标签 的 
情况 下 ， 仍 然 会 原原本本 地 同 用 户 显 示 这 些 内 容 ， 所 以 用 户 将 在 晤 不 知 
情 的 情况 下 ， 使 用 自己 的 权限 去 执行 攻击 者 发 布 的 恶意 代码 。 预 防 这 一 
攻击 的 常见 方法 就 是 在 显示 或 者 存储 用 户 传 入 的 数据 之 前 ， 对 数据 进行 
转 义 。 但 正如 很 多 漏洞 以 及 bug 一 样 ， 持 和 久 性 XSS 漏 洞 往往 会 由 于 人 为 
的 因素 而 出 现 。 




















为 了 说 明 如 何 防御 持久 性 XSS 漏 洞 ， 我 们 需要 用 到 一 些 HTML 表 单 
数据 。 这 一 次 ， 比 起 直接 将 数据 硬 编码 到 处 理 器 里 面 ， 更 好 的 选择 是 使 
用 第 4 章 学 到 的 HIML 表 单 知 识 ， 创 建 一 个 代码 清单 5-19 所 示 的 HIML 表 
单 。 这 个 表单 允许 我 们 向 Web 应 用 发 送 数据 ， 并 将 其 存储 在 form .html 
文件 中 。 

















代码 清单 5-19 ”用 于 实施 XSS 攻 击 的 表单 











<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
<form action="/process" method="post"> 


Comment: <input name="comment" type="text"> 
<hr/> 
<button id="submit" >Submit</button> 
</form> 
</body> 
</html> 





接着 ， 为 了 处 理 来 自 HTML 表 单 的 数据 ， 我 们 需要 对 人 处理 器 做 相应 
的 修改 ， 如 代码 清单 5-20 所 示 。 


代码 清单 5-20 ”测试 XSS 攻 击 








package main 


import ( 
"net/http" 
"html/template" 
) 


func process(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("tmpl.html") 
t.Execute(w, r.FormValue("comment")) 


} 


func form(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("form.html1") 
t.Execute(w, nil) 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


http.HandleFunc("/process", process) 
http.HandleFunc("/form", form) 
server.ListenAndServe() 








最 后 ， 为 了 让 XSS 攻 击 的 测试 结果 可 以 更 好 地 显示 出 来 ， 我 们 需要 
修改 tmp1.html 模板 文件 ， 如 代码 清单 5-21 所 示 。 








代码 清单 5-21 修改 后 的 tmpl.html 模板 





<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 


<body> 
<div>{{ . }}</div> 
</body> 
</html> 





现在 ， 编 译 并 启动 修改 后 的 服务 器 ， 然 后 访问 
http://127.0.0.1:8080/form。 接 着 像 图 5-9 所 示 的 那样 ， 将 以 下 内 容 输 入 到 
表单 的 文本 框 里 面 ， 然 后 按 下 Submit 按 钮 : 


<script>alert('Pwnd!');</script> 


PO 


对 于 那些 不 过 滤 用 户 输入 并 且 在 Web 页 面 上 直接 显示 用 户 输入 的 模 
板 引擎 来 说 ， 执 行 图 5-9 所 示 的 操作 将 会 显示 一 条 提示 信息 ， 这 也 意味 
着 攻击 者 可 以 让 网 站 上 的 其 他 用 户 执 行 任意 可 能 的 攻击 代码 。 与 此 相 
反 ， 正 如 我 们 之 前 提 到 的 那样 ， 即 使 程序 员 忘 了 对 用 户 的 输入 进行 过 
滤 ，Go 的 模板 引擎 也 会 在 显示 用 户 输入 时 将 其 转换 为 转 义 之 后 的 
HTML， 以 此 来 避免 可 能 会 出 现 的 问题 ， 图 5-10 证 实 了 这 一 点 。 





eco < > 127.0.0.1:8080/form 
Comment: <script>alert('Pywnd!’):</script> 


Submit 


图 5-9 ”用 于 实施 XSS 攻 击 的 表单 


eee < 127.0.0.1:8080/process s 由 


<scriptalert(‘Pwnd!');</script> 


图 5-10 ”多谢 Go 的 模板 引擎 ， 原 本 会 导致 漏洞 的 用 户 输入 已 经 被 转 义 了 
查看 这 个 页 面 的 源 代码 将 会 看 到 以 下 结果 : 


<html> 
<head> 
<meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
<title>GoWebProgramming</title> 
</head> 


<body> 
<div>&lt;script&gt ; alert (&#39; Pwnd! &#39;);&1t;/script&gt; </div> 
</body> 
</html> 





上 下 文 感知 功能 不 仅 能 够 自动 对 HTML 进 行 转 义 ， 它 还 能 够 防止 基 
于 JavaScript、CSS 甚 至 URL 的 XSS 攻 击 。 那 么 这 是 否 意味 着 我 们 只 要 使 
用 Go 的 模板 引擎 就 可 以 无 忧 无 虑 地 进行 开发 了 呢 ? 并 非 如 此 ， 上 下 文 
感知 虽然 很 方便 ， 但 它 并 非 灵 丹 妙 药 ， 而 且 有 不 少 方法 可 以 绕 开 上 下 文 
感知 。 实 际 上 ， 如 果 需 要 ， 用 户 是 可 以 完全 不 使 用 上 下 文 感知 特性 的 。 


5.6.2 ”不 对 HTML 进行 转 义 


如 果真 的 想 要 允许 用 户 输入 HTML 代码 或 者 JavaScript 代 码 ， 
示 内 容 时 执行 这 些 代 码 ， 可 以 使 用 Go 提供 的 “不 转 义 HIML2” 机 制 : 上 
把 不 想 被 转 义 的 内 容 传 给 template.HTML 函数 ， 模 板 引 擎 cee 
进行 转 义 。 作 为 例子 ， 让 我 们 对 之 前 展示 过 的 处 理 器 做 一 些小 修改 : 








func process(w http.ResponsewWriter, r *http.Request) { 
t, := template.ParseFiles("tmpl.htm1") 


t.Execute(w, template.HTML(r.FormValue("comment" ) ) ) 


} 





注意 ， 在 这 个 修改 后 的 处 理 器 函数 中 ， 程 序 通过 类 型 转换 
(typecast) 将 表单 中 的 评论 值 转换 成 了 template .HTML 类 型 。 


现在 ， 重 新 编译 并 运行 这 个 服务 器 ， 然 后 再 次 尝试 实施 XSS 攻 击 。 
攻击 产生 的 结果 将 根据 用 户 使 用 的 浏览 器 而 定 ， 如 果 用 户 使 用 的 是 
Chrome、Safari、IE8 或 以 上 版 本 的 下 浏览 器 ， 那 么 什么 都 不 会 发 生 一 一 
用 户 将 看 到 一 个 空 昌 的 页 面 ; 但 如 果 用 户 使 用 的 是 Firefox， 那 么 用 户 将 
会 看 到 图 5-11 所 示 的 画面 。 


因为 正 、Chrome 和 Safari 在 默认 情况 下 都 能 够 防御 某 些 特定 类 型 的 
XSS 攻 击 ， 所 以 我 们 的 XSS 攻 击 在 这 3 个 浏览 器 上 都 没有 能 够 成 功 实施 ; 
与 此 相反 ， 因 为 Firefox 并 不 具备 内 置 的 XSS 防 御 功 能 ， 所 以 我 们 在 
Firefox 浏 览 器 上 成 功 实施 了 XSS 攻 击 。 


在 需要 时 ， 用 户 也 可 以 通过 发 送 一 个 最 初 由 微软 公司 为 正 浏 览 器 创 
建 的 特殊 HTTP 响应 首部 XXXSS-Protection 来 让 浏览 器 关闭 内 置 的 XSS 防 
御 功 能 ， 就 像 这 样 : 


func process(w http.ResponsewWriter, r *http.Request) { 
w.Header().Set("X-XSS-Protection", "@") 
t, _ := template.ParseFiles("tmpl.htm1") 
t.Execute(w, template.HTML(r.FormValue( "comment" ) ) ) 


Transferring data from 127.0.0.1... 





图 5-11 XSS 攻 击 成 功 


现在 ， 如 果 再 次 尝试 实施 XSS 攻 击 ， 那 么 你 将 会 在 下 、Chrome 和 
Safari 上 看 到 与 Firefox 相 同 的 攻击 效果 。 


5.7 RERIK 





本 章 到 目前 为 止 已 经 介绍 了 Go 模板 引擎 的 不 少 特性 ， 在 继续 了 解 
更 多 特性 之 前 ， 我 们 需要 先 学 习 一 下 如 何在 Web 应 用 中 使 用 布局 。 





所 谓 的 布局 〈layout) ， 指 的 是 web 设 计 中 可 以 重复 应 用 在 多 个 页 
面 上 的 固定 模式 。 为 了 构建 协调 一 致 的 用 户 界 面 ，Web 应 用 常常 需要 展 
示 一 些 相 似 的 页 面 ， 因 此 Web 应 用 也 会 经 常用 到 布局 。 比 如 说 ， 很 多 
Web 应 用 都 拥有 相应 的 涉 部 菜单 ， 以 及 提供 服务 器 状态 、 版 权 声 明 、 联 
系 方式 等 附加 信息 的 尾部 栏 ， 而 其 他 一 些 Web 应 用 可 能 会 在 屏幕 的 左 侧 
提供 导航 栏 又 或 者 多 级 导航 染 单 。 不 难 猜 出 ， 这 些 布局 实际 上 都 可 以 使 
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种 方法 来 开发 复杂 的 Web 应 用 ， 不 仅 需 要 将 大 量 代码 便 编 码 到 处 理 器 里 
面 ， 还 需要 创建 大 量 的 模板 文件 ， 而 引发 这 一 问题 的 原因 跟 我 们 使 用 模 
板 的 方式 有 关 。 


正如 之 前 所 说 ， 我 们 可 以 通过 包含 动作 ， 在 一 个 模板 里 面包 含 为 一 
个 模板 : 


{{ template "name" . }} 


其 中 动作 的 参数 name 残 是 被 包含 模板 的 名 字 ， 并 且 这 个 名 字 还 是 一 个 
字符 串 第 量 。 这 意味 着 如 果 我 们 继续 像 之 前 一 样 ， 使 用 文件 名 作为 模板 








名 ， 那 么 因为 每 个 页 面 都 拥有 它们 各 目的 布局 模板 文件 ， 所 以 程序 最 终 
将 无 法 拥有 任何 可 共用 的 公共 布局 ， 而 这 种 做 法 跟 构 建 布局 的 想法 正好 
是 相 背 的 。 比 如 说 ， 对 于 代码 清单 5-22 所 示 的 模板 文件 ， 我 们 就 不 能 把 
它 用 作 公 共 的 布局 模板 文件 。 














代码 清 





5-22 无效 的 模板 布局 文件 











<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 


<title>Go Web Programming</title> 
</head> 
<body> 
{{ template "content.html" }} 
</body> 
</html> 





出 现 这 种 问题 的 根源 在 于 我 们 实际 上 并 没有 以 正确 的 方式 使 用 Go 
模板 引擎 。 尽 管 我 们 可 以 让 每 个 模板 文件 都 只 定义 一 个 模板 ， 并 将 模板 
文件 的 名 字 用 作 模 板 的 名 字 ， 但 实际 上 ， 我 们 也 可 以 通过 定义 动作 
(define action) ， 在 模板 文件 里 面 显 式 地 定义 模板 ， 吏 像 代码 清单 5-23 
所 示 的 那样 。 














代码 清 





5-23” 显 式 地 定义 一 个 模板 














{{ define "layout" }} 


<html> 

<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 

</head> 

<body> 
{{ template "content" }} 

</body> 


</html> 


{{ end }} 





这 个 文件 以 一 个 {{ define "layout" }} 标签 作 开 头 ， 并 以 一 个 
{{ end }} 标签 结尾 ， 而 介 于 这 两 个 标签 之 间 的 内 容 束 是 layout 模板 
的 定义 。 与 此 同时 ， 通 过 使 用 另 一 个 定义 动作 ， 我 们 还 可 以 在 这 个 文件 
里 面 再 多 创建 一 个 模板 。 换 句 话 说， 我 们 可 以 像 代 码 清单 5-24 所 示 的 那 
样 ， 在 同一 个 模板 文件 里 面 定 义 多 个 不 同 的 模板 。 





























代码 清单 5-24 在 一 个 模板 文件 里 面 定 义 多 个 模板 














{{ define "layout" }} 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 
{{ template "content" }} 
</body> 
</html> 


{{ end }} 


{{ define "content" }} 


Hello World! 


{{ end }} 





代码 清单 5-25 展 示 了 处 理 器 使 用 这 些 模板 的 方法 。 

















代码 清单 5-25 ”使 用 显 式 定义 的 模板 











func process(w http.ResponsewWriter, r *http.Request) { 
t, _ := template.ParseFiles("layout.htm1") 
t.ExecuteTemplate(w, "layout", "") 


} 





分 析 模 板 的 方法 跟 之 前 介绍 过 的 一 样 ， 但 是 这 次 在 执行 模板 的 时 
候 ， 程 序 需要 显 式 地 使 用 ExecuteTemplate 方法 ， 并 把 待 执 行 的 
layout 模板 的 名 字 用 作 方 法 的 第 二 个 参数 。 因 为 layout RMIRE I 
content 模板 ， 所 以 程序 只 需要 执行 1ayout ipsa 以 在 浏览 器 中 得 
到 content 模板 产生 的 Hello World! 输出 了 。 通 过 使 用 cURL 获取 模 
板 输 出 的 实际 HTML 文 件 ， 我 们 将 看 到 以 下 结果 : 





> curl -i http://127.0.0.1:8080/process 
HTTP/1.1 200 OK 

Date: Sun, 08 Feb 2015 14:09:15 GMT 
Content-Length: 187 

Content-Type: text/html; charset=utf-8 


<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
<title>Go Web Programming</title> 
</head> 
<body> 


Hello World! 


</body> 
</html> 





用 户 除 可 以 在 同一 个 模板 文件 里 面 定义 多 个 不 同 的 模板 之 外 ， 还 可 
以 在 不 同 的 模板 文件 里 面 定 义 同名 的 模板 。 作 为 例子 ， 让 我 们 首先 移 
除 1ayout .html 文件 中 现 有 的 content 模板 定义 ， 然 后 分 别 在 代码 清 


单 5-26 和 代码 清单 5-27 所 示 的 red_hello.html 文件 和 





blue_hello.html 文件 中 重新 定义 content 模板 。 








代码 清和 











5-26 red_hello.html 








{{ define "content" }} 


<h1 style="color: red;">Hello World!</h1> 


{{ end }} 























代码 清 





{{ define "content" }} 
<h1 style="color: blue;">Hello World!</h1> 


{{ end }} 





5-27 blue_hello.html 





代码 清早 5-28 展 示 了 修改 之 后 的 处 理 费 ， 它 疝 我 们 演示 了 应 该 如 何 


使 用 在 不 同 模 板 文件 中 定义 的 两 个 content 模板 。 


























代码 清单 5-28 ”处 理 器 使 用 在 不 同 模 板 文件 中 定义 的 同名 模板 




















func process(w http.ResponseWriter, r *http.Request) { 
rand.Seed(time.Now().Unix()) 
var t *template.Template 
if rand.Intn(10) > 5 { 








t, _ = template.ParseFiles("layout.html", "red_hello.htm1") 


} else { 


t, _ = template.ParseFiles("layout.html", "blue hello.html") 


} 
t.ExecuteTemplate(w, "layout", "") 





这 个 处 理 器 会 根据 生成 的 随机 数 ， 决 定 对 red_hello.html 和 
blue_hello.html 这 两 个 模板 文件 中 的 哪 一 个 进行 语法 分 析 。 当 处 理 
器 像 之 前 一 样 执行 包含 了 content 模板 的 layout 模板 时 ， 被 随机 选中 
的 那个 模板 文件 中 定义 的 content 模板 就 会 被 执行 。 

为 red_hello.html 和 blue_hello.html 这 两 个 模板 文件 都 定义 了 
content 模板 ， 所 以 它们 中 的 哪 一 个 被 随机 选中 了 进行 语法 分 机， 被 分 
析 文 件 中 定义 的 content 模板 就 会 被 执行 。 换 名 话说， 我 们 可 以 在 维 
持 “layout 模板 包含 content 模板 ”这 一 关系 不 变 的 情况 下 ， 通 过 对 不 
同 的 模板 文件 进行 语法 分 析 来 达到 改变 输出 结果 的 目的 。 


现在 ， 如 果 我 们 重新 编译 并 启动 修改 后 的 服务 占 ， 然 后 通过 浏览 器 
对 其 进行 访问 ， 那 么 我 们 将 会 随机 看 到 药 色 或 者 红色 的 Hello World! 
输出 ， 就 像 图 5-12 所 示 的 那样 。 


@ee < 127.0.0.1:8080/process : (hy 


Hello World! 


图 5-12 ”能 够 随机 切换 内 容 的 模板 





5.8 WRITE E MERU ARK 


Go 1.6 引 入 了 一 个 新 的 块 动作 (block action) ， 这 个 动作 允许 用 户 
定义 一 个 模板 并 且 立 即使 用 。 块 动作 看 上 去 是 下 面 这 个 样子 的 : 


{{ block arg }} 
Dot is set to arg 


{{ end }} 





为 了 更 好 地 了 解 块 动作 的 使 用 方法 ， 我 们 将 使 用 块 动作 重新 实现 上 
一 节 展 示 过 的 例子 ， 并 在 处 理 器 没有 指定 特定 的 模板 时 ， 默 认 展 示 赣 色 
的 Hello World 模 板 。 代 码 清单 5-29 展 示 了 修改 之 后 的 处 理 器 ， 正 如 加 粗 
的 代码 行 所 示 ， 处 理 器 的 else 块 将 不 再 同时 分 析 layout .html 文件 和 
blue_hello.html 文件 ， 而 是 只 分 析 Layout .html 文件 。 











代码 清单 5-29 只 对 1ayout.html 进行 语法 分 析 





func process(w http.ResponsewWriter, r *http.Request) { 
rand.Seed(time.Now().Unix()) 
var t *template. Template 
if rand.Intn(10) > 5 { 
t, _ = template.ParseFiles("layout.html", "red_hello.htm1") 
} else { 
t, _ = template.ParseFiles("layout.htm1" ) 


} 
t.ExecuteTemplate(w, "layout", "") 





如 采 我 们 现在 就 重新 编译 并 局 动 服 务 器 ， 那 么 服务 器 就 会 因为 
Eelse 块 中 找 不 到 需要 进行 语法 分 析 的 content 模板 而 出 现 随机 骨 误 
的 情况 。 为 了 解决 这 个 问题 ， 我 们 需要 像 代码 清单 5-30 所 示 的 那样 ， 
在 1ayout .html 模板 文件 中 通过 块 动作 定义 content 模板 ， 并 将 其 用 
作 默 认 的 content 模板 。 


























代码 清单 5-30 ”通过 块 动作 添加 默认 的 content 模板 




















{{ define "layout" }} 


< html> 
< head> 
< meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 
< title>Go Web Programming< /title> 
< /head> 
< body> 
{{ block "content" . }} 


< h1 style="color: blue;">Hello World!< /h1> 


{{ end }} 


< /body> 
< /html> 


{{ end }} 





块 动作 能 够 高 效 地 定义 一 个 content 模板 ， 并 将 它 放置 到 layout 
模板 里 面 。 当 layout 模板 被 执行 时 ， 如 果 模 板 引擎 没有 找到 可 用 的 
content 模板 ， 那 么 它 就 会 使 用 块 动 作 中 定义 的 content 模板 。 


在 最 近 的 这 几 章 ， 我 们 学 习 了 如 何 接收 请 求 ， 如 何 处 理 请 求 ， 以 及 
如 何 生成 用 于 响应 请 求 的 内 容 ， 而 在 接 下 来 的 一 章 ， 我 们 将 要 学 习 如 何 
通过 Go 语言 将 数据 存储 到 内 存 、 文 件 或 者 数据 库 里 面 。 


5.9 ”小 结 


生 Web 应 用 中 ， 模 板 引 擎 会 把 模板 和 数据 进行 合并 ， 生 成 将 要 返回 
给 客户 端的 HTML 。 

Go 的 标准 模板 引擎 定义 在 htm1/template 包 当 中 。 

Go 模板 引擎 的 工作 方式 就 是 对 一 个 模板 进行 语法 分 析 ， 接 着 在 执 
行 这 个 模板 的 时 候 ， 将 一 个 ResponseWriter 以 及 一 些 数据 传递 给 
它 。 被 调用 的 模板 引擎 会 对 传 入 的 已 分 析 模 板 以 及 数据 进行 合并 ， 
然后 把 合并 的 结果 传递 给 ResponseWriter 。 

Go 的 模板 拥有 一 系列 丰富 多 样 并且 威 力 强 大 的 动作 ， 这 些 动作 就 
是 一 系列 命令 ， 它 们 可 以 告诉 模板 应 该 以 何 种 方式 与 数据 合并 。 
除了 动作 之 外 ， 模 板 还 可 以 包含 参数 、 管 道 和 变量 : 其 中 参数 用 于 
表示 模板 中 的 数据 值 ， 管 道 用 于 串联 起 多 个 参数 和 函数 ， 至 于 变量 
则 会 作为 动作 的 组 件 而 存在 。 

Go 拥有 一 系列 受 限 的 模板 函数 。 此 外 ， 通 过 创建 一 个 函数 映射 并 
将 它 与 模板 进行 绑 定 ， 用 户 也 可 以 创建 出 自己 的 模板 函数 。 
Go 的 模板 引擎 可 以 根据 数据 所 在 的 位 置 改变 数据 的 显示 方式 ， 这 
种 上 下 文 感知 特性 能 够 有 效 地 防御 XSS 攻 击 。 

人 们 在 设计 一 个 拥有 一 致 外 观 和 使 用 感受 的 Web 应 用 时 ， 常 常会 用 
到 Web 布 局 ，Go 可 以 使 用 和 伦 套 模板 来 实现 Web 布 局 。 














Rei FF fe BOA 


本 章 主要 内 容 


。 使 用 结构 进行 内 存 存 储 

。 使 用 CSV 和 和 gob 二进制 文件 进行 文件 存储 
。 使 用 SQL 进 行 关系 数据 库存 储 

© Go 与 SQL 映射 器 








本 书 在 第 2 章 引入 了 数据 持久 化 这 一 概念 ， 并 简单 地 介绍 了 如 何 将 
数据 持久 化 到 PostgreSQL 这 个 关系 数据 库 中 。 本 章 将 会 继续 深入 讨论 数 
据 持久 化 这 一 主题 ， 并 说 明 如 何 才 能 将 数据 存储 到 内 存 、 文 件 、 关 系数 
据 库 以 及 NoSQL 数 据 库 中 。 





尽 绾 数据 持久 化 从 技术 上 来 说 并 不 属于 Web 应 用 编程 的 范畴 ， 但 因 
为 绝 大 部 分 Web 应 用 都 会 以 东 种 形式 存储 数据 ， 所 以 数据 持久 化 是 除了 
模板 和 处 理 需 这 两 大 文 柱 之 外 ， 任 何 Web 应 用 都 必 不 可 少 的 第 三 大 文 
KE 


Web 应 用 通常 会 采取 以 下 手段 存储 数据 : 


o 在 程序 运行 时 ， 将 数据 存储 到 内 存 里 面 ; 
。 将 数据 存储 到 文件 系统 的 文件 里 面 ; 
o 通过 服务 器 程序 前 跨 ， 将 数据 存储 到 数据 库 里 面 。 


在 本 章 中 ， 我 们 将 会 分 别 通过 以 上 这 3 种 手段 ， 使 用 Go 对 数据 进行 


访问 ， 并 对 数据 执行 俗称 CRUD 的 创建 、 获 取 、 更 新 和 删除 这 4 个 操 
作 。 


6.1 内 存 存储 











本 节 所 说 的 内 存 存储 指 的 是 将 数据 存储 在 运行 中 的 应 用 里 面 ， 并 在 
应 用 运行 的 过 程 中 使 用 这 些 数 据 ， 而 不 是 说 将 数据 存储 到 内 存 数据 库 里 
面 。 将 数据 存储 在 数据 结构 里 面 是 实现 内 存 存储 的 常见 手段 ， 对 于 Go 
语言 来 说 ， 这 意味 着 使 用 数组 、 切 片 、 映 射 和 结构 来 存储 数据 。 





存储 数据 这 一 操作 本 时 是 非常 简单 的 ， 用 户 只 需要 创建 相应 的 结 
构 、 切 片 和 映射 就 可 以 了 。 但 如 果 我 们 更 加 深入 地 思考 这 个 问题 就 会 发 
现 ， 程 序 最 终 操作 的 将 不 是 一 个 个 单独 的 结构 ， 而 是 一 系列 由 容器 
(container) ARMENA: 这 些 容 器 既 可 以 是 数组 、 切 片 和 映射 ， 
也 可 以 是 栈 、 树 、 队 列 以 及 其 他 任意 类 型 的 数据 结构 。 


除 容 露 本身 之 外 ， 如 何 从 容器 里 面 获取 所 需 的 数据 也 是 一 个 非常 有 
趣 的 问题 。 比 如 说 ， 代 码 清单 6-1 束 展示 了 一 个 使 用 映射 作为 结构 容器 
的 例子 。 

















代码 清单 6-1 在 内 存 里 面 存储 数据 














package main 


import ( 
"fmt" 


) 


type Post struct { 
Id int 
Content string 
Author string 
} 


var PostById map[int]*Post 


var PostsByAuthor map[string][]*Post 


func store(post Post) { 
PostById[post.Id] = &post 
PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], &post) 


} 


func main() { 


PostById = make(map[int]*Post) 
PostsByAuthor = make(map[string][]*Post) 


post1 := Post{Id: 
post2 := Post{Id: 
post3 := Post{Id: 
post4 := Post{Id: 
"Sau Sheong"} 
store(post1) 
store(post2) 
store(post3) 
store(post4) 


， Content: "Hello World!", Author: "Sau Sheong"} 
， Content: "Bonjour Monde!", Author: "Pierre"} 

, Content: "Hola Mundo!", Author: "Pedro"} 

， Content: "Greetings Earthlings!", Author: 


AUNE 


fmt.Println(PostById[1]) 
fmt.Println(PostById[2]) 


for _, post := range PostsByAuthor["Sau Sheong"] { 
fmt .Println(post) 

} 

for _, post := range PostsByAuthor["Pedro"] { 
fmt .Println(post) 


} 





y 


这 个 程序 会 使 用 Post 结构 来 表示 论坛 应 用 中 的 帖子 ， 并 将 该 结构 
存储 在 内 存 里 面 : 











type Post struct { 
Id int 
Content string 


Author string 





Post 结构 中 最 主要 的 数据 是 帖子 的 内 容 ， 用 户 也 可 以 通过 帖子 的 
唯一 ID 或 者 帖子 作者 的 名 字 来 获取 帖子 。 程 序 会 通过 将 一 个 代表 帖子 的 
键 映 冉 至 实际 的 Post 结构 来 存储 多 个 帖子 。 为 了 提供 两 种 不 同 的 方法 
来 访问 帖子 ， 程 序 分 别 使 用 了 两 个 map 来 创建 两 种 不 同 的 映射 : 


var PostById map[int]*Post 
var PostsByAuthor map[string][]*Post 


程序 使 用 了 两 个 变量 来 存储 映射 ， 其 中 PostById 变量 会 将 帖子 的 
唯一 ID 映射 至 指向 帖子 的 指针 ， 而 PostsByAuthor 变量 则 会 将 作者 的 
名 字 映 射 人 至 一 个 切 厂 ， 这 个 切 厂 可 以 包含 多 个 指 同 帖子 的 指针 。 注 意 ， 
无 论 是 PostById 还 是 PostsByAuthor ， 它 们 映射 的 都 是 指向 帖子 的 指 
针 而 不 是 帖子 本 身 。 这 样 做 可 以 确保 程序 无 论 是 通过 ID 还 是 通过 作者 的 
名 字 来 获取 帖子 ， 得 到 的 都 是 相同 的 帖子 ， 而 不 是 同一 帖子 的 不 同 副 
A. 

















在 此 之 后 ， 程 序 定义 了 用 于 存储 帖子 的 store 函数 : 


func store(post Post) { 
PostById[post.Id] = &post 
PostsByAuthor[post.Author] = append(PostsByAuthor[post.Author], &post) 


} 





store PA — AJ al FRET OD dF if BU PostBylId 变量 和 
PostsByAuthor 变量 里 面 。 紧 接着 ， 在 main() 函数 里 面 ， 程 序 创 建 了 
多 个 将 要 被 存储 的 帖子 ， 这 个 过 程 唯一 要 做 的 就 是 创建 多 个 Post 结构 
的 实例 : 


Post{Id: Content: "Hello World!", Author: "Sau Sheong"} 
Post{Id: Content: "Bonjour Monde!", Author: "Pierre"} 

Post{Id: Content: "Hola Mundo!", Author: "Pedro"} 

Post{Id: Content: "Greetings Earthlings!", Author: "Sau Sheong 





接着 程序 会 调用 前 面 定 义 的 store 函数 ， 把 这 些 帖子 一 一 存储 起 
来 : 


store(post1) 
store(post2) 
store(post3) 
store(post4) 





如 果 运 行 这 个 程序 ， 我 们 将 会 看 到 以 下 输出 : 


&{1 Hello World! Sau Sheong} 
&{2 Bonjour Monde! Pierre} 
&{1 Hello World! Sau Sheong} 


&{4 Greetings Earthlings! Sau Sheong} 
&{3 Hola Mundo! Pedro} 








注意 ， 无 论 程序 是 通过 帖子 的 ID 还 是 帖子 的 作者 获取 帖子 ， 最 终 得 
到 的 都 是 同一 个 帖子 。 





这 个 例子 看 上 去 非常 简单 直接 ， 甚 至 可 以 说 有 点 儿 简 单 过 头 了 。 我 
们 之 所 以 要 学 习 怎 样 将 数据 存储 在 内 存 里 面 ， 是 因为 人 们 在 构建 Web 应 
用 的 时 候 ， 营 常会 像 第 2 章 展 示 的 那样 ， 从 一 开始 束 使 用 关系 数据 库 ， 
然后 在 进行 性 能 扩展 的 时 候 ， 才 认识 到 目 己 需要 将 数据 库 返 回 的 结果 组 
存 起 来 以 提高 性 能 。 正 如 本 章 接 下 来 要 介绍 的 内 容 所 示 ， 对 数据 进行 持 








久 化 的 绝 大 部 分 手段 都 会 以 这 样 或 那样 的 形式 使 用 结构 ， 在 学 完 本 市 介 
绍 的 方法 之 后 ， 我 们 束 可 以 在 进行 性 能 扩展 的 时 候 ， 通 过 重 构 代码 来 将 
绥 存 数据 存储 在 内 存 里 面 ， 而 不 一 定 非 得 要 使 用 类 似 Redis 那 样 的 外 部 
内 存 数据 库 。 


因为 将 数据 存储 到 结构 里 面 对 数 据 存 储 操作 是 一 种 非常 重要 的 重 现 
手段 ， 所 以 本 间 以 及 后 续 章节 还 会 继续 提 及 这 一 技术 。 


6.2 ”文件 存储 


因为 内 存 存储 不 需要 访问 人 硬盘， 所 以 相关 操作 通常 部会 以 风 驰 电 单 
般 的 速度 完成 。 但 内 存 存储 有 一 个 不 容 忽 视 的 缺点 ， 那 就 是 ， 存 储 在 内 
存 中 的 数据 并 不 是 持久 化 的 。 如 果 你 的 计算 机 或 者 程序 可 以 永远 也 不 关 
闭 ， 又 或 者 你 的 数据 像 缓 存 一 样 即 使 丢失 了 也 无 所 谓 ， 那 么 这 个 缺点 对 
你 来 说 是 无 伤 大 雅 的 ， 但 很 多 时 候 ， 即 使 是 对 于 绥 存 数据 来 说 ， 我 们 还 
古 希 望 数据 可 以 在 计算 机 关闭 或 者 程序 关闭 之 后 继续 存在 。 实 现 数 据 持 
久 化 有 好 几 种 不 同 的 方式 可 选 ， 其 中 最 第 见 的 英 过 于 将 数据 存储 到 诸如 
人 硬盘 或 者 内 存 这 样 的 非 易 失 存 储 嚣 里面。 


























把 数据 存储 到 非 易 失 存 储 器 里 面 同样 也 有 多 种 方法 可 选 ， 而 本 节 要 
介绍 的 是 把 数据 存储 到 文件 系统 里 面 的 相关 技术 。 说 得 更 具体 一 点 ， 我 
们 将 要 学 习 的 是 如 何 通 过 Go 语言 以 两 种 不 同 的 方式 将 数据 存储 到 文件 
里 面 : 第 一 种 方式 需要 用 到 通用 的 CSV (comma-separated value， 过 号 
分 隔 值 ) 文本 格式 ， 而 第 二 种 方法 则 需要 用 到 Go 语言 特有 的 gob 包 。 





CSV 是 一 种 常见 的 文件 格式 ， 用 户 可 以 通过 这 种 格式 同系 统 传递 数 
据 。 当 你 需要 用 户 提供 大 量 数据 ， 但 是 却 因为 某 些 原因 而 无 法 让 用 户 把 
数据 填 入 你 提供 的 表单 时 ，CSV 格 式 就 可 以 派 上 用 场 了 : 你 只 需要 让 用 
户 使 用 电子 表格 程序 (spreadsheet) 输入 所 有 数据 ， 然 后 将 这 些 数据 导 
出 为 CSV 文 件 ， 并 将 其 上 传 到 你 的 Web 应 用 中 ， 这 样 就 可 以 在 获得 CSV 
文件 之 后 ， 根 据 自 己 的 需要 对 数据 进行 解码 。 同 样 地 ， 你 的 web 应 用 也 
可 以 将 用 户 的 数据 打包 成 CSV 文 件 ， 然 后 通过 向 用 户 发 送 CSV 文 件 来 为 
他 们 提供 数据 。 














gob 是 一 种 能 够 存储 在 文件 里 面 的 二 进 制 格式 ， 这 种 格式 可 以 快速 
且 高 效 地 将 内 存 中 的 数据 序列 化 到 一 个 或 多 个 文件 里 面 。 二 进 制 数据 文 
件 的 用 途 非 常 多 ， 比 如 ， 在 进行 数据 备份 以 及 有 序 关 机 H 的 时 候 ， 程 





序 束 可 以 使 用 二 进 制 数据 文件 来 快速 地 存储 程序 中 的 结构 。 正 如 绥 存 机 
制 对 应 用 程序 来 说 非常 有 用 一 样 ， 能 够 将 数据 暂时 存储 在 文件 里 面 ， 并 
在 需要 的 时 候 读 取 这 些 数据 ， 对 于 实现 会 话 、 购 物 车 以 及 构建 临时 工作 
空间 Cworkspace) 也 是 非常 有 用 的 。 








代码 清单 6-2 展 示 了 打开 一 个 文件 并 对 其 进行 号 入 的 具体 方法 ， 在 
讨论 CSV 文 件 和 gob 二 进 制 文件 的 过 程 中 ， 类 似 的 代码 将 会 反复 出 现 。 











进行 读 写 





package main 


import ( 
ili fmt ili 
"io/ioutil" 
n" os " 

) 


func main() { 


data := []byte("Hello World!\n") 


err := ioutil.WriteFile("data1", data, 0644) @ 


if err != nil { 
panic(err) 
read1, _ := ioutil.ReadFile("data1") 


fmt.Print(string(read1)) 


file1, _ := os.Create("data2") @ 
defer file1.Close() 


bytes, := filel.Write(data) 


fmt.Printf("Wrote %d bytes to file\n", bytes) 


file2, _ := os.Open("data2") 
defer file2.Close() 


read2 := make([]byte, len(data)) 

bytes, _ = file2.Read(read2) 

fmt.Printf("Read %d bytes from file\n", bytes) 
fmt.Printin(string(read2) ) 





Q 通过 WriteFile 函数 和 ReadFile 函数 对 文件 进行 号 入 和 读 取 


O 通过 File 结构 对 文件 进行 号 入 和 读 取 


为 了 减少 需要 展示 的 代码 ， 代 码 清单 6-2 中 的 程序 使 用 了 空白 标识 
符 来 省 略 各 个 函数 可 能 会 返回 的 错误 。 





在 这 个 代码 清单 里 面 ， 程 序 使 用 了 两 种 不 同 的 方法 来 对 文件 进行 写 
入 和 读 取 。 第 一 种 方法 非常 简单 直接 ， 它 使 用 的 是 ioutil 包 中 的 
WriteFile 函数 和 ReadFile ma: 在 写 入 文件 时 ， 程 序 会 将 文件 的 名 
字 、 需 要 写 入 的 数据 以 及 一 个 用 于 设置 文件 权限 的 数字 用 作 参 数 调 
用 WriteFile 函数 ， 而 在 读 取 文件 时 ， 程 序 只 需要 将 文件 的 名 字 用 作 参 
数 ， 然 后 调用 ReadFile 函数 即 可 。 此 外 ， 无 论 是 传递 给 WriteFile 的 
数据 ， 还 是 ReadFile 返回 的 数据 ， 都 是 一 个 由 字 节 组 成 的 切片 。 














比 起 前 一 种 方法 ， 使 用 File 结构 读 写 文件 会 显得 更 为 麻烦 一 些 ， 
但 这 种 做 法 的 灵活 性 更 高 。 在 使 用 这 种 方法 实现 文件 写 入 时 ， 程 序 需 要 
先 调用 os 包 的 Create 函数 ， 并 通过 癌 该 函数 传 入 文件 名 来 创建 文件 。 
使 用 defer 关闭 文件 是 一 种 值得 提倡 的 做 法 ， 因 为 它 杜 绝 了 用 户 在 使 用 
文件 之 后 忘记 关闭 文件 的 问题 。defer 语句 可 以 将 给 定 的 函数 调用 推 入 
到 一 个 栈 里 面 ， 保 存在 栈 中 的 调用 会 在 包含 defer 语句 的 函数 返回 之 后 











执行 。 对 我 们 的 例子 来 襄 ， 这 意味 着 file1l 和 file2 将 会 在 main 函数 
执行 完毕 之 后 关闭 。 在 拥有 了 File 结构 之 后 ， 程 序 就 可 以 通过 它 的 
Write 方法 对 文件 进行 写 入 。 除 了 Write 方法 之 外 ，File 结构 还 提供 
了 其 他 几 个 用 于 写 入 文件 的 方法 。 


使 用 File 结构 读 取 文件 的 方法 跟 写 入 文件 的 方法 类 似 : 程序 需要 
使 用 os 包 的 Open 函数 打开 文件 ， 然 后 使 用 File 结构 提供 的 Read 方法 
或 者 其 他 读 取 方法 来 读 取 文 件 中 的 数据 。 因 为 File 结构 提供 了 一 些 方 
法 ， 它 们 允许 用 户 定位 并 读 取 文件 中 的 指定 部 分 ， 所 以 使 用 File 结构 
来 读 取 文件 比 起 单纯 地 调用 ReadFile 函数 拥有 更 大 的 灵活 性 。 





执行 代码 清单 6-2 所 示 的 程序 会 创建 datal 和 data2 两 个 文件 ， 它 
们 都 包含 文本 “ Hello World!”。 


6.2.1 读 取 和 写 入 CSV 文 件 


CSV 格 式 是 一 种 文件 格式 ， 它 可 以 让 文本 编辑 器 非常 方便 地 读 写 由 
文本 和 数字 组 成 的 表格 数据 。CSV 的 应 用 非常 广泛 ， 包 括 微软 的 Excel 
和 苹果 的 Numbers 在 内 的 绝 大 多 数 电子 表格 程序 都 广 持 CSV 格 式 ， 因 此 
包括 Go 在 内 的 很 多 编程 语言 都 提供 了 能 够 生成 和 处 理 CSV 文 件数 据 的 函 
数 库 。 


对 Go 语言 来 说 ，CSV 文 件 可 以 通过 encoding/csv 包 进 行 操作 ， 代 
码 清单 6-3 展 示 了 如 何 通过 这 个 包 来 读 写 CSV 文 件 。 


代码 清单 6-3 ” 读 写 CSV 文 件 


package main 





import ( 
"encoding/csv" 
"fmt" 


"strconv" 


) 


type Post struct { 
Id int 
Content string 
Author string 
} 
func main() { 
csvFile, err 
if err != nil { 
panic(err) 


} 


defer csvFile.Close() 


allPosts := []Post{ 


:= os.Create("posts.csv") @ 


Post{Id: 1, Content: "Hello World!", Author: "Sau Sheong"}, 
Post{Id: 2, Content: "Bonjour Monde!", Author: "Pierre"}, 
Post{Id: 3, Content: "Hola Mundo!", Author: "Pedro"}, 
Post{Id: 4, Content: "Greetings Earthlings!", Author: "Sau Sheong"} 
3 
} 
writer := csv.NewWriter(csvFile) 


for _, post := 


range allPosts { 


line := []string{strconv.Itoa(post.Id), post.Content, post.Author} 


err := writer.Write(line) 
if err != nil { 
panic(err) 
} 
} 
writer.Flush() 
file, err := os.Open("posts.csv") @ 
if err != nil { 
panic(err) 
} 


defer file.Close() 


reader := csv.NewReader(file) 


reader.FieldsPerRecord = 
reader.ReadAl11() 


record, err := 
if err != nil { 
panic(err) 


-1 


} 


var posts []Post 

for _, item := range record { 
id, _ := strconv.ParseInt(item[@], ©, ©) 
post := Post{Id: int(id), Content: item[1], Author: item[2]} 
posts = append(posts, post) 

} 

fmt.Println(posts[@].Id) 

fmt.Println(posts[@].Content) 

fmt.Println(posts[@].Author) 





@ 创建 一 个 CSV 文件 


@ 打开 一 个 CSV 文件 


首先 让 我 们 来 了 解 一 下 如 何 对 CSV 文 件 执行 写 操 作 。 在 一 开始 ， 程 
序 会 创建 一 个 名 为 posts .csv 的 文件 以 及 一 个 名 为 csvFile 的 变量 ， 
而 后 续 代码 的 目标 则 是 将 allPosts 变量 中 的 所 有 帖子 都 写 入 这 个 文 
件 。 为 了 完成 这 一 目标 ， 程 序 会 使 用 NewWriter 函数 创建 一 个 新 的 写 入 
器 (writer) ， 并 把 文件 用 作 参 数 ， 将 其 传递 给 写 入 器 。 在 此 之 后 ， 程 
序 会 为 每 个 竺 写 入 的 帖子 都 创建 一 个 由 字符 串 组 成 的 切片 。 最 后 ， 程 序 
调用 写 入 器 的 Write 方法 ， 将 一 系列 由 字符 串 组 成 的 切片 写 入 之 前 创建 
的 CSV 文 件 。 











如 果 程 序 进 行 到 这 一 步 就 结束 并 退出 ， 那 么 前 面 提 到 的 所 有 数据 都 
会 被 写 入 文件 ， 但 由 于 程序 在 接 下 来 的 代码 中 立即 就 要 对 写 入 的 
posts.csv 文件 进行 读 取 ， 而 刚刚 写 入 的 数据 有 可 能 还 滞留 在 绥 冲 区 
中 ， 所 以 程序 必须 调用 写 入 器 的 Flush 方法 来 保证 缓冲 区 中 的 所 有 数据 
都 已 经 被 正确 地 写 入 文件 里 面 了 。 








读 取 CSV 文 件 的 方法 和 写 入 文件 的 方法 类 似 。 首 先 ， 程 序 会 打开 文 
件 ， 并 通过 将 文件 传递 给 NewReader 函数 来 创建 出 一 个 读 取 器 
(reader) 。 接 着 ， 程 序 会 将 读 取 器 的 FieldsPerRecord 字段 的 值 设 置 
为 负数 ， 这 样 的 话 ， 即 使 读 取 器 在 读 取 时 发 现 记录 (record) 里 面 缺 少 
了 某 些 字段 ， 读 取 进 程 也 不 会 被 中 断 。 反 之 ， 如 果 FieldsPerRecord 
字段 的 值 为 正 数 ， 那 么 这 个 值 就 是 用 户 要 求 从 每 条 记录 里 面 读 取 出 的 字 
段 数量 ， 当 读 取 器 从 CSV 文 件 里 面 读 取 出 的 字段 数量 少 于 这 个 值 时 ，Go 
就 会 抛 出 一 个 错误 。 最 后 ， 如 果 FieldsPerRecord 字段 的 值 为 6 ， 那 
么 读 取 器 就 会 将 读 取 到 的 第 一 条 记录 的 字段 数量 用 
作 FieldsPerRecord 的 值 。 





在 设置 好 FieldsPerRecord 字段 之 后 ， 程 序 会 调用 读 取 器 的 
ReadAll 方法 ， 一 次 性 地 读 取 文 件 中 包含 的 所 有 记录 ; 但 如 果 文 件 的 体 
积 较 大 ， 用 户 也 可 以 通过 读 取 器 提 供 的 其 他 方法 ， 以 每 次 一 条 记录 的 方 
式 读 取 文 件 。ReadA11 方法 将 返回 一 个 由 一 系列 切片 组 成 的 切片 作为 结 
果 ， 程 序 会 遍历 这 个 切片 ， 并 为 每 条 记录 创建 对 应 的 Post 结构 。 如 果 
我 们 运行 代码 清单 6-3 所 示 的 程序 ， 那 么 程序 将 创建 一 个 名 
为 posts.csyv 的 CSV 文 件 ， 该 文件 将 包含 以 下 多 个 由 逗号 分 隔 的 文本 
行 : 





1,Hello World!,Sau Sheong 
2,Bonjour Monde! ,Pierre 
3,Hola Mundo! , Pedro 


4,Greetings Earthlings! ,Sau Sheong 





除 此 之 外 ， 这 个 程序 还 会 读 取 posts .csv 文件 ， 并 打印 出 该 文件 第 


一 行 的 内 容 : 


1 
Hello World! 


Sau Sheong 





6.2.2 gob, 


encoding/gob 包 用 于 管理 由 gob 组 成 的 流 (stream) ， 这 是 一 种 在 
编码 器 Cencoder) 和 解码 器 (decoder) 之 间 进 行 交 换 的 三 进 制 数 据 ， 
这 种 数据 原本 是 为 序列 化 以 及 数据 传输 而 设计 的 ， 但 它 也 可 以 用 于 对 数 
据 进 行 持久 化 ， 并 且 为 了 让 用 户 能 够 方便 地 对 文件 进行 读 写 ， 编 码 器 和 
解码 器 一 般 都 会 分 别 包 囊 起 程序 的 写 入 器 以 及 读 取 器 。 代 码 清单 6-4 展 
示 了 如 何 使 用 gob 包 去 创建 二 进 制 数据 文件 ， 以 及 如 何 去 读 取 这 些 文 
a 








代码 清单 6-4 使 用 gob 包 读 写 二 进 制 数 据 

















package main 


import ( 
"bytes" 
"encoding/gob" 
"fmt" 
"io/ioutil" 

) 


type Post struct { 
Id int 
Content string 
Author string 
} 


func store(data interface{}, filename string) { @ 
buffer := new(bytes.Buffer) 
encoder := gob.NewEncoder (buffer) 


err := encoder.Encode(data) 
if err != nil { 
panic(err) 


err = ioutil.WriteFile(filename, buffer.Bytes(), 0600) 
if err != nil { 
panic(err) 


} 


func load(data interface{}, filename string) { @ 
raw, err := ioutil.ReadFile(filename) 
if err != nil { 
panic(err) 


buffer := bytes.NewBuffer(raw) 
dec := gob.NewDecoder (buffer) 
err = dec.Decode(data) 
if err != nil { 
panic(err) 
} 
} 


func main() { 
post := Post{Id: 1, Content: "Hello World!", Author: "Sau Sheong"} 
store(post, "post1") 
var postRead Post 
load(&postRead, "post1") 
fmt.Println(postRead) 





@ 存储 数据 


O 载 入 数据 


跟前 面 展 示 的 程序 一 样 ， 代 码 清 单 6-4 所 示 的 程序 也 会 用 到 Post 结 
构 ， 并 且 也 包含 了 相应 的 store 方法 和 1oad 方法 ， 但 是 跟 之 前 不 一 样 
的 是 ， 这 次 的 store 方法 会 将 帖子 存储 为 二 进 制 数 据 ， 而 1oad 方法 则 
会 通过 读 取 这 些 二 进 制 数据 来 获取 帖子 。 


首先 来 分 析 一 下 store 函数 ， 这 个 函数 的 第 一 个 参数 是 一 个 空 接 
口 ， 而 第 二 个 参数 则 是 被 存储 的 二 进 制 文件 的 名 字 。 虽 然 空 接口 参数 能 
够 接受 任意 类 型 的 数据 作为 值 ， 但 是 在 这 个 函数 里 面 ， 它 接受 的 将 是 一 
个 Post 结构 。 在 接受 了 相应 的 参数 之 后 ，store 函数 会 创建 一 
个 bytes .Buffer 结构 ， 这 个 结构 实际 上 就 是 一 个 拥有 Read 方法 和 
Write 方法 的 可 变 长 度 (variable-sized) 字 节 缓冲 区 ， 换 句 话 
ti, bytes.Buffer 既是 读 取 器 也 是 写 入 右 。 


在 此 之 后 ，store 函数 会 把 缓冲 区 传递 给 NewEncoder 函数 ， 以 此 
来 创建 出 一 个 gob 编 码 嚣 ， 接 着 调用 编码 右 的 Encode 方法 将 数据 (也 束 
是 Post 结构 ) 编码 到 缓冲 区 里 面 ， 最 后 再 将 缓冲 区 中 己 编 码 的 数据 写 
入 文件 。 





程序 在 调用 store 函数 时 ， 会 将 一 个 Post 结构 和 一 个 文件 名 作为 
参数 ， 而 这 个 函数 则 会 创建 出 一 个 名 为 post1 的 三 进 制 数 据 文 件 。 


接 下 来 ， 让 我 们 来 研究 一 下 load 函数 ， 这 个 函数 从 二 进 制 数 据 文 
件 中 载 入 数据 的 步骤 跟 创建 并 写 入 这 个 文件 的 步骤 正好 相反 : 首先 ， 程 
序 会 从 文件 里 面 读 取出 未 经 处 理 的 原始 数据 ;， 接着， 程序 会 根据 这 些 原 
始 数据 创建 一 个 绥 冲 区 ， 并 夭 此 为 原始 数据 提供 相应 的 Read 方法 和 
Write 方法 ; 在 此 之 后 ， 程 序 会 调用 NewDecoder 函数 ， 为 缓冲 区 创建 
相应 的 解码 器 ， 然 后 使 用 解码 器 去 解码 从 文件 中 读 取 的 原始 数据 ， 并 最 
终 得 到 之 前 写 入 的 Post 结构 。 





在 main 函数 里 面 ， 程 序 定 义 了 一 个 名 为 postRead 的 Post 结构 ， 
并 将 这 个 结构 的 引用 以 及 二 进 制 数 据 文件 的 名 字 传 递 给 了 load 函数 ， 


TM Load 函数 则 会 把 读 取 二 进 制 文 件 所 得 的 数据 载 入 给 定 的 Post 结构 。 


当 我 们 运行 代码 清单 6-4 所 示 的 程序 时 ， 将 创建 出 一 个 包含 二 进 制 
数据 的 post1 文件 一 一 因为 这 个 文件 包含 的 是 二 进 制 数 据 ， 所 以 如 果 直 
接 打 开 这 个 文件 ， 将 会 看 到 一 些 似乎 晤 无 意义 的 数据 。 除 创建 post1 X 
件 之 外 ， 程 序 还 会 读 取 文件 中 的 数据 并 将 其 载 入 Post 结构 里 面 ， 然 后 
在 控制 终端 打印 出 这 个 结构 : 


{1 Hello World! Sau Sheong} 


好 了 ， 关 于 使 用 文件 存储 数据 的 介绍 到 此 就 结束 了 ， 本 章 接 下 来 的 
内 容 将 会 讨论 如 何 将 数据 存储 到 一 种 名 为 数据 库 服务 器 的 特殊 服务 器 端 
程序 里 面 。 


6.3 ”Go 与 SQL 


在 内 存 和 文件 系统 上 存储 和 访问 数据 虽然 非常 有 用 ， 但 如 果 你 希望 
在 一 个 健壮 并 且 可 扩展 的 环境 里 面 存储 数据 ， 就 需要 转 回 使 用 数据 库 服 
Bas (database server) 。 数 据 库 服 务 器 是 一 种 程序 ， 它 可 以 让 其 他 程 
序 通过 客户 端 -服务 器 模型 (client-server model) 来 访问 数据 ， 并 且 这 种 
访问 只 能 通过 数据 库 服 务 器 实现 ， 而 其 他 形式 的 访问 则 会 被 拒绝 。 在 通 
常情 况 下 ， 数 据 库 服务 器 的 客户 端 既 可 以 是 一 个 阔 数 库 ， 也 可 以 是 男 一 
个 程序 ， 这 个 客户 端 会 与 数据 库 服务 器 进行 连接 ， 然 后 通过 结构 化 查询 
语言 (structured query language, SQL) 对 数据 进行 访问 。 数 据 库 服务 
颖 通常 会 作为 系统 的 一 部 分 ， 出 现在 数据 库 管 理 系统 (database 


management system) 中 。 


关系 数据 库 管理 系统 (relational database management system, 
RDBMS) 也 许 是 最 常见 也 最 流行 的 数据 库 管 理 系 统 了 人 ， 这 种 系统 使 用 
的 是 基于 数据 的 关系 模型 构建 的 关系 数据 库 。 在 绝 大 多 数 情况 下 ， 关 
系数 据 库 服务 器 都 是 通过 SQL 来 访问 关系 数据 库 的 。 








关系 数据 库 和 SQL 是 人 们 在 实现 可 扩展 并 且 易 于 使 用 的 数据 存储 方 
法 时 最 为 常见 的 手段 。 本 书 曾 经 在 第 2 章 对 关系 数据 库 以 及 SQL 做 过 简 
单 的 介绍 ， 而 我 们 接 下 来 要 做 的 是 更 加 深入 地 了 解 这 两 项 技术 。 


6.3.1 设置 数据 库 


在 开始 学 习 本 市 介绍 的 知识 之 前 ， 读 者 首先 要 做 的 就 是 对 数据 库 进 
行 设置 。 本 书 在 第 2 半 束 曾经 介绍 过 安装 并 设置 Postgres 的 具体 方法 ， 








为 本 节 还 会 继续 用 到 Postgres 数 据 库 ， 所 以 如 果 你 尚未 安装 或 者 设置 好 
这 个 数据 库 ， 那 么 请 根据 第 2 章 介 绍 的 方法 进行 设置 。 





在 启动 并 设置 好 数据 库 之 后 ， 我 们 还 需要 执行 以 下 3 个 步 又 : 
(1) 创建 数据 库 用 户 ; 

(2) 为 用 户 创建 数据 库 ; 

(3) RITRAE, BERTHAR EN mK 


首先 ， 我 们 可 以 通过 在 命令 行 执行 以 下 命令 来 创建 数据 库 用 户 : 


createuser -P -d gwp 


这 一 命令 会 创建 出 一 个 名 为 gwp 的 Postgres 数 据 库 有 用户， 其 中 -P 选 
项 会 让 createuser 程序 在 执行 时 弹出 一 个 提示 符 ， 只 需要 在 提示 符 出 
现 之 后 输入 相应 的 字符 串 ， 就 可 以 将 其 设置 为 gwp 用 户 的 密码 ， 而 -d 选 
项 则 会 赋予 gwp 用 户 创建 数据 库 所 需 的 权限 。 





RE, RIEN gwp 用 户 创建 数据 库 。 通 过 在 命令 行 执 行 以 下 
命令 ， 我 们 束 可 以 创建 一 个 名 为 gwp 的 数据 库 : 


createdb gwp 


注意 ， 这 个 数据 库 的 名 字 跟 我 们 刚刚 创建 的 数据 库 用 户 的 名 字 是 一 
样 的 ， 都 是 gwp。 虽 然 数 据 库 用 户 也 可 以 创建 与 目 己 名 字 不 同 的 数据 





库 ， 但 这 样 做 需要 额外 的 权限 设置 ， 所 以 为 了 让 事情 尽 可 能 简单 ， 我 们 
这 里 将 使 用 默认 的 数据 库 命 名 方式 ， 也 就 是 ， 为 数据 库 用 户 创建 一 个 与 
之 同名 的 数据 库 。 





在 拥有 了 数据 库 之 后 ， 我 们 还 需要 创建 一 个 表 ， 这 个 表 也 是 接 下 来 
的 内 容 中 我 们 唯一 需要 使 用 的 表 。 首 先 ， 我 们 需要 创建 一 个 名 
为 setup.sql 的 文件 ， 并 将 代码 清单 6-5 所 示 的 内 容 键入 该 文件 中 。 





代码 清单 6-5 ”用 于 创建 表 的 脚本 





create table posts ( 

id serial primary key, 
content text, 

author varchar(255) 


); 





接着 ， 我 们 还 需要 在 命令 行 执行 以 下 命令 : 


psql -U gwp -f setup.sql -d gwp 





REM Ta, ERATE Re POR BEAD BUEN TE. HERR, TERE 
次 执行 后 续 展 示 的 代码 之 前 ， 你 可 能 都 需要 重复 执行 一 次 这 条 命令 ， 以 


便 清 理 并 设置 数据 库 。 


在 创建 并 设置 好 数据 库 之 后 ， 现 在 是 时 候 来 连接 这 个 数据 库 了 。 代 
码 清单 6-6 展 示 了 一 个 名 为 store. go 的 文件 ， 文 件 中 的 代码 对 Postgres 
执行 了 一 系列 操作 ， 而 接 下 来 的 小 节 将 会 逐一 地 分 析 这 些 操作 的 实现 原 
理 。 























代码 清单 6-6 ”使 用 Go 对 Postgres 执 行 CRUD 操 作 








package main 


import ( 
"database/sql" 
"fmt" 
_ "github.com/1lib/pq' 


) 


type Post struct { 
Id int 
Content string 
Author string 
} 
var Db *sql.DB 
func init() { 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
=»sslmode=disable") @ 


if err != nil { 
panic(err) 
} 
} 
func Posts(limit int) (posts []Post, err error) { 
rows, err := Db.Query("select id, content, author from posts limit $1" 
3 
=» limit) 
if err != nil { 
return 
} 


for rows.Next() { 
post := Post{} 
err = rows.Scan(&post.Id, &post.Content, &post.Author) 
if err != nil { 
return 


} 
posts = append(posts, post) 


} 
rows.Close() 
return 


} 


func GetPost(id int) (post Post, err error) { @ 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = 


m1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 
} 
func (post *Post) Create() (err error) { © 
statement := "insert into posts (content, author) values ($1, $2) 
wreturning id" 
stmt, err := Db.Prepare(statement) 
if err != nil { 
return 
} 


defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


} 


func (post *Post) Update() (err error) { 
_, err = Db.Exec("update posts set content = $2, author = $3 where id 


$1", post.Id, post.Content, post.Author) @ 
return 


} 


func (post *Post) Delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) © 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
© 
fmt.Println(post) 
post.Create() 
fmt.Println(post) @ 


readPost, _ := GetPost(post.Id) 
fmt.Println(readPost) © 


readPost.Content = "Bonjour Monde!" 
readPost.Author = "Pierre" 


readPost.Update() 


posts, _ := Posts() 
fmt.Println(posts) © 


readPost.Delete() 


pO 


@ 连接 到 数据 库 

O 获取 单独 一 篇 帖子 

© 创建 一 篇 新 帖子 

O 更 新 帖子 

O 删除 一 篇 帖子 

@ {0 Hello World! Sau Sheong} 

@ {1 Hello World! Sau Sheong} 

@ {1 Hello World! Sau Sheong} 

© [{1 Bonjour Monde! Pierre}] 
6.3.2 ”连接 数据 库 


程序 在 对 数据 库 执 行 任何 操作 之 前 ， 都 需要 先 与 数据 库 进 行 连接 ， 
代码 清单 6-7 展 示 了 实现 这 一 动作 的 具体 过 程 : 程序 首先 使 用 Db 变量 定 
义 了 一 个 指向 sql.DB 结构 的 指针 ， 然 后 使 用 init() 函数 来 初始 化 这 个 
变量 (Go 语言 的 每 个 包 都 会 自动 调用 定义 在 包 内 的 init() 函数 ) 。 























代码 清单 6-7 ”用 于 创建 数据 库 句柄 的 函数 


var Db *sql.DB 
func init() { 





var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
sslmode=disable" ) 
if err != nil { 
panic(err) 
} 
} 





sql.DB 结构 是 一 个 数据 库 句 柄 Chandle) ， 它 代表 的 是 一 个 包含 
了 零 个 或 任意 多 个 数据 库 连 接 的 连接 池 《〈pool) ， 这 个 连接 池 由 sq1 包 





管理 。 程 序 可 以 通过 调用 Open 函数 ， 并 将 相应 的 数据 库 张 动 名 字 
(driver name) 以 及 数据 源 名 字 (data source name) 传递 给 该 函数 来 建 
立 与 数据 库 的 连接 。 比 如 ， 在 上 面 展 示 的 例子 中 ， 程 序 使 用 的 是 
postgres 驱 动 。 数 据 源 名 字 是 一 个 特定 于 数据 库 驱 动 的 字符 串 ， 它 会 告 
诉 驱 动 应 该 如 何 与 数据 库 进 行 连接 。0pen 函数 在 执行 之 后 会 返回 一 个 
fale] sql.DB 结构 的 指针 作为 结果 。 





需要 注意 的 是 ，0pen 函数 在 执行 时 并 不 会 真正 地 与 数据 库 进 行 连 
接 ， 它 甚至 不 会 检查 用 户 给 定 的 参数 : Open 函数 的 真正 作用 是 设置 好 
连接 数据 库 所 需 的 各 个 结构 ， 并 以 惰性 的 方式 ， 等 到 真正 需要 时 才 建 立 
相应 的 数据 库 连 接 。 


此 外 ， 因 为 sq1.DB 只 是 一 个 句柄 而 不 是 实际 的 连接 ， 而 这 个 句柄 
代表 的 是 一 个 会 目 动 对 连接 进行 管理 的 连接 池 ， 上 所 以 尽管 用 户 可 以 手动 
关闭 sql.DB ， 但 是 在 实际 中 通常 并 不 需要 这 样 做 。 在 上 面 展示 的 例子 
中 ， 程 序 通过 全 局 定义 的 Db 变量 在 各 个 CRUD 方 法 以 及 函数 中 使 
用 sql1.DB 结构 ; 但 除 此 之 外 ， 我 们 也 可 以 选择 在 创建 sq1.DB 结构 之 
后 ， 通 过 同方 法 或 者 函数 传递 这 个 结构 的 方式 来 使 用 它 。 








到 目前 为 止 ， 我 们 讨论 的 都 是 0pen 函数 ， 这 个 函数 接受 数据 库 驱 
动 名 字 和 数据 源 名 字 作 为 参数 ， 然 后 返回 一 个 sql .DB 结构 作为 结果 。 
那么 程序 本 里 又 是 如 何 获取 数据 库 驱 动 的 呢 ? 一 般 来 说 ， 程 序 都 会 
In|Register 函数 提供 一 个 数据 库 驱 动 名 字 以 及 一 个 实现 了 
driver.Driver 接口 的 结构 ， 以 此 来 注册 将 要 用 到 的 数据 库 驱 动 ， 就 
像 这 样 : 


sql.Register("postgres", &drv{}) 


这 个 例子 中 的 postgres 就 是 数据 库 驱 动 的 名 字 ， 而 drv 则 是 实现 
了 Driver 接口 的 结构 。 你 也 许 已 经 注意 到 了 ， 前 面 展示 的 数据 库 程序 
并 没有 包含 类 似 的 注册 代码 ， 这 是 因为 程序 使 用 的 第 三 方 Postgres 驱 动 
在 被 导入 的 时 候 已 经 自行 实现 了 注册 : 




















"database/sql" 


_ "github.com/lib/pq" 








上 面 这 上 段 代 码 中 的 github.com/1ib/pq 包 就 是 程序 导入 的 Postgres 
驱动 ， 在 导入 这 个 包 之 后 ， 包 内 定义 的 init 函数 就 会 被 调用 ， 并 对 其 
自身 进行 注册 。 因 为 Go 语言 没有 提供 任何 官方 数据 库 驱 动 ， 所 以 Go 语 
言 的 所 有 数据 库 驱 动 都 是 第 三 方 函 数 库 ， 并 且 这 些 库 必须 遵守 
sql.driver 包 中 定义 的 接口 。 注 意 ， 因 为 程序 在 操作 数据 库 的 时 候 只 
需要 用 到 database/sql ， 而 不 需要 直接 使 用 数据 库 驱 动 ， 所 以 程序 在 

















导入 Postgres 数 据 库 驱动 的 时 候 将 这 个 包 的 名 字 设 置 成 了 下 划 线 (_) 。 
这 种 引用 数据 库 驱 动 的 方式 可 以 让 用 户 在 不 修改 代码 的 情况 下 升级 驱 
动 ， 或 者 修改 驱动 实现 。 


至 于 安装 驱动 这 一 操作 ， 则 可 以 通过 在 命令 行 里 执行 以 下 命令 来 完 
成 : 


go get "github.com/lib/pq" 


这 一 命令 会 从 代码 库 中 获取 驱动 的 具体 代码 ， 并 将 这 些 代码 放置 到 
包 库 (package repository) 里 面 ， 当 需要 用 到 这 个 驱动 时 ， 编 译 占 束 会 
把 驱动 代码 与 用 户 编 写 的 代码 一 同 编译 。 


6.3.3 ”创建 帖子 


在 完成 了 数据 库 的 初步 设置 之 后 ， 现 在 是 时 候 创建 我 们 的 首 条 数据 
库 记 录 了 。 本 节 还 会 用 到 之 前 几 节 展示 过 的 Post 结构 ， 跟 之 前 不 一 样 
的 是 ， 这 次 展示 的 程序 将 不 会 再 把 post 结构 包含 的 信息 存储 到 内 存 或 
者 文件 中 ， 而 是 把 这 些 信息 存储 到 Postgres 数 据 库 中 ， 并 在 需要 的 时 候 
从 数据 库 中 获取 这 些 信息 。 

















前 面 的 示例 程序 向 我 们 展示 了 如 何 使 用 不 同 的 函数 执行 数据 的 创 
建 、 获 取 、 更 新 和 删除 操作 ， 而 在 这 一 节 ， 我 们 将 会 了 解 到 使 
用 Create 函数 创建 新 帖子 的 更 多 细节 。 在 仔细 研究 Create 函数 的 代码 
之 前 ， 让 我 们 先 来 了 解 一 下 创建 帖子 的 具体 步骤 。 


创建 帖子 首先 要 做 的 是 创建 一 个 Post 结构 ， 并 为 该 结构 的 





Content 字段 和 Author 字段 设置 值 。 需 要 注意 的 是 ， 因 为 结构 的 Id + 
段 的 值 通常 是 由 数据 库 的 自 增 主键 自动 生成 的 ， 所 以 我 们 并 不 需要 为 这 
个 字段 设置 值 。 





post := Post{Content: "Hello World!", Author: "Sau Sheong"} 





如 果 我 们 现在 使 用 一 个 fmt .Println 语句 打印 这 个 结构 ， 会 看 
到 Id 字段 的 值 被 初始 化 成 了 8 : 


fmt.Println(post) ©@ 


@ {0 Hello World! Sau Sheong} 


现在 ， 我 们 可 以 通过 执行 Post 结构 的 Create 方法 ， 把 结构 中 包含 
的 数据 存储 到 数据 库 的 记录 (record) 里 面 : 


post.Create() 


Create 方法 在 发 生 故 障 时 会 返回 一 个 错误 ， 但 为 了 让 代码 保持 简 
单 ， 我 们 这 里 暂且 先 省 略 相 应 的 错误 处 理 代 码 。 现 在， 再 次 打印 这 
个 Post 结构 : 


fmt.Println(post) 


W 


@ {1 Hello World! Sau Sheong} 


从 打印 的 结果 可 以 看 到 ，Id 字段 的 值 现在 被 设置 成 了 1 。 在 了 解 了 
使 用 Create 函数 创建 新 帖子 的 具体 步骤 之 后 ， 现 在 是 时 候 来 看 看 代码 
清单 6-8， 了 解 一 下 它 的 具体 实现 代码 了 。 














代码 清单 6-8 创建 一 篇 帖子 





func (post *Post) Create() (err error) { 
statement := "insert into posts (content, author) values ($1, $2) 
returning id " 
stmt, err := db.Prepare(statement) 
if err != nil { 
return 


defer stmt.Close() 


err = stmt.QueryRow(post.Content, post.Author) .Scan(&post.Id) 
if err != nil { 
return 


} 


return 





Create 函数 是 Post 结构 的 一 个 方法 ， 这 一 点 可 以 通过 Create K 
数 的 定义 看 出 : Efun 关键 字 和 函数 名 Create 之 间 ， 有 一 个 指 问 Post 
结构 的 引用 ， 这 个 名 为 post 的 引用 也 被 称 为 方法 的 接收 者 
(receiver) ， 接 收 者 可 以 不 使 用 & 符号 ， 直 接 在 方法 内 部 对 结构 进行 引 
用 。 





Create 方法 做 的 第 一 件 事 是 定义 一 条 SQL 预 处 理 语句 ， 一 条 预 处 
理 语句 (prepared statement) 就 是 一 个 SQL 语 句 模 板 ， 这 种 语句 通常 用 
于 重复 执行 指定 的 SQL 语句 ， 用 户 在 执行 预 处 理 语句 时 需要 为 语句 中 的 
参数 提供 实际 值 。 





比如 ， 在 创建 数据 库 记 录 的 时 候 ，Create 函数 就 会 使 用 实际 值 去 
蔡 换 以 下 语句 中 的 $1 和 $2 : 


statement := "insert into posts (content, author) values ($1, $2) returnin 
g id" 





除了 在 数据 库 里 面 创建 记录 之 外 ， 这 个 语句 还 会 要 求 数据 库 返 回 id 
列 的 值 ， 本 文 稍 后 就 会 说 明 这 样 做 的 具体 原因 。 


为 了 创建 预 处 理 语句 ， 程 序 使 用 了 sq1.DB 结构 的 Prepare 方法 : 


stmt, err := db.Prepare(statement) 


这 行 代码 会 创建 一 个 指向 sql.Stmt 接口 的 引用 ， 这 个 引用 就 是 上 
面 提 到 的 预 处 理 语 句 。sq1.Stmt 接口 的 定义 位 于 sql.Driver 包 当 
中 ， 而 具体 的 结构 则 由 数据 库 驱 动 实现 。 


之 后 ， 程 序 会 调用 预 处 理 语句 的 QueryRow 方法 ， 并 把 来 自 接收 者 
的 数据 传递 给 该 方法 ， 以 此 来 执行 预 处 理 语句 : 


err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 


我 们 之 所 以 在 这 里 使 用 QueryRow 方法 ， 是 因为 我 们 只 想 要 获取 一 
个 指 癌 sql.Row 结构 的 引用 : 如 果 QueryRow 发 现 被 执行 的 SQL 语句 返 
回 了 多 于 一 个 sql.Row ， 那 么 它 只 会 返回 结果 中 的 第 一 个 sql.Row ， 并 
丢弃 剩余 的 所 有 sql.Row 。 因 为 QueryRow 方法 的 返回 值 只 有 一 


个 sql.Row 结构 ， 它 不 会 返回 任何 错误 ， 所 以 QueryRow 方法 通常 会 跟 
Row 结构 的 Scan 方法 搭配 使 用 ， 并 由 Scan 方法 把 行 中 的 值 复 制 到 程序 
为 其 提供 的 参数 里 面 。 正 如 上 面 的 代码 所 示 ，Scan 方法 会 把 SQL 查询 
语句 返回 的 id 列 的 值 设 置 为 post 接收 者 的 Id 字段 的 值 ， 这 也 是 我 们 前 
面 在 编写 预 处 理 语句 时 ， 要 求 SQL 查 询 语句 返回 id 列 的 值 的 原因 。 很 
明显 ， 因 为 接收 者 的 Content 字段 和 Author 字段 都 已 经 有 值 了 ， 所 以 
程序 最 后 要 做 的 就 是 将 接收 者 的 Id 字段 的 值 设置 成 数据 库 生成 的 自 增 
整数 。 现 在 ， 正 如 你 所 料 ， 因 为 post 变量 的 Id 字段 也 已 经 设置 了 值 ， 
所 以 程序 得 到 的 将 是 一 个 完整 地 进行 了 设置 的 Post 结构 ， 并 且 该 结构 
包含 的 数据 与 数据 库 记 录 的 数据 完全 一 致 。 


6.3.4 获取 帖子 


在 学 会 如 何 创 建 帖 子 之 后 ， 我 们 很 自然 地 就 要 学 习 如 何 获 取 帖 子 
了 。 跟 前 面 一 样 ， 在 编写 获取 帖子 的 函数 之 前 ， 我 们 需要 先 了 解 一 下 获 
取 帖 子 的 具体 步骤 。 因 为 程序 在 尝试 获取 帖子 的 时 候 是 没有 现成 的 Post 
结构 可 用 的 ， 所 以 它 目 然 也 无 法 通过 为 Post 结构 定义 方法 来 获取 帖子 
了 。 为 此 ， 程 序 需要 定义 一 个 GetPost 函数 ， 这 个 函数 接受 帖子 的 Id 作 
为 参数 ， 并 返回 一 个 包含 了 完整 帖子 数据 的 Post 结构 作为 结果 : 








readPost, _ := GetPost(1) 
fmt.Println(readPost) @ 


@ {1 Hello World! Sau Sheong} 


IERRA AZARAE SI AREF, GetPost 函数 传 


递 post.Id 变量 ， 而 是 直接 向 GetPost MACE SHES AID 值 1 L 
此 来 强调 函数 是 通过 帖子 ID 来 获取 帖子 的 。 代 码 清单 6-9 展 示 了 
GetPost 函数 的 具体 实现 代码 。 





代码 清单 6-9 ”获取 一 篇 帖子 





func GetPost(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = 
$1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 





GetPost 函数 首先 创建 了 一 个 空 的 Post 结构 ， 然 后 在 对 结构 进行 
设置 之 后 ， 将 其 用 作 函 数 的 返回 值 : 


post = Post{} 


跟 之 前 一 样 ， 程 序 通过 串联 QueryRow 方法 和 Scan 方法 ， 将 执行 查 
询 所 得 的 数据 复制 到 空 的 Post 结构 里 面 。 需 要 注意 的 是 ， 因 为 获取 单 
个 帖子 无 需 重 复 执行 相同 的 SQL 语句 ， 所 以 程序 使 用 的 是 sq1.DB 结构 
的 QueryRow 方法 而 不 是 sql .Stmt 结构 的 QueryRow 方法 。 实 际 
E, Create 方法 和 GetPost 函数 既 可 以 使 用 sq1.DB 来 实现 ， 也 可 以 使 
用 sq1.Sstmt 来 实现 ， 在 这 里 使 用 sq1 .DB 而 不 是 沿用 sql1.Stmt 只 是 为 
了 展示 男 一 种 可 行 的 做 法 。 

















a so 结构 之 后 ，GetPost 就 会 
将 这 个 结构 返回 给 调用 函数 。 


63.5 ”更 新 帖子 


在 学 会 如 何 获 取 帖 子 之 后 ， 我 们 接 下 来 要 做 的 就 是 学 习 如 何 对 数据 
库 记 录 中 的 信息 进行 更 新 。 假 设 现在 程序 已 经 通过 获取 操作 把 帖子 保存 
到 了 readPost 变量 里 面 ， 那 么 它 应 该 可 以 对 帖子 进行 修改 ， 并 通过 更 
新 操作 将 这 些 修改 反映 至 数据 库 : 














readPost.Content = "Bonjour Monde!" 
readPost.Author = "Pierre" 


readPost.Update() 





更 新 操作 可 以 通过 为 Post 结构 添加 Update 方法 来 实现 ， 代 码 清单 
6-10 展 示 了 这 个 方法 的 具体 实现 代码 。 











代码 清单 6-10 更 新 一 篇 帖子 














func (post *Post) Update() (err error) { 
_, err = Db.Exec("update posts set content = $2, author = $3 where id 


$1", post.Id, post.Content, post.Author) 


return 





跟 创 建 帖子 时 的 做 法 不 同 ， 这 次 展示 的 更 新 操作 没有 使 用 预 处 理 语 
句 ， 而 是 直接 调用 sql1.DB 结构 的 Exec 方法 。 这 是 因为 程序 既 不 需要 对 
接收 者 进行 任何 更 新 ， 也 不 需要 对 方法 返回 的 结果 进行 扫描 《scan) ， 
所 以 它 才 会 选择 使 用 速度 更 快 的 Exec 方法 来 执行 查询 : 


_, err = Db.Exec(post.Id, post.Content, post.Author) 





Exec 方法 会 返回 一 个 sql.Result 和 一 个 可 能 出 现 的 错误 ， 其 中 
sql.Result 记录 的 是 受 查 询 影 响 的 行 的 数量 以 及 可 能 会 出 现 的 最 后 插 
入 id。 因 为 更 新 操作 对 sql.Result 记录 的 这 两 项 信息 都 不 感 兴趣 ， 所 
以 程序 会 通过 将 sql.Result WA PRIZE C) 来 忽略 它 。 如 果 一 切 
顺利 ， 没 有 出 现 错误 ， 当 Exec 执行 完毕 时 ， 给 定 的 帖子 就 会 被 更 新 。 








6.3.6 ”删除 帖子 


到 目前 为 止 ， 我 们 已 经 学 习 了 如 何 创建 、 获 取 和 更 新 帖子 ， 那 么 接 
下 来 要 考虑 的 就 是 如 何在 不 需要 这 些 帖 子 的 时 候 删 除 它们 了 。 比 如 说 ， 
假设 程序 已 经 通过 获取 操作 将 一 篇 帖子 存储 到 了 readPost 变量 里 面 ， 
那么 接 下 来 就 可 以 通过 调用 readPost 变量 的 Delete 方法 来 删除 帖子 : 


readPost.Delete() 


Delete 方法 的 用 法 非常 简单 ， 代 码 清单 6-11 展 示 了 这 个 方法 的 具 
体 定 义 ， 里 面 使 用 的 都 是 前 面 已 经 介绍 过 的 技术 。 




















代码 清单 6-11 删除 一 篇 帖子 














func (post *Post) Delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 


return 


} 





跟前 面 更 新 帖子 时 一 样 ，Delete 方法 直接 通过 调用 sq1l1 .DB 结构 的 
Exec 方法 来 执行 SQL 查询 ， 并 且 因 为 Delete 方法 也 对 Exec 方法 返回 


的 结果 不 感 兴趣 ， 所 以 它 也 会 把 Exec 返回 的 结果 赋值 给 了 下 划 线 (_) 


也 许 你 已 经 注意 到 了 ， 与 Post 结构 有 关 的 各 个 方法 以 及 函数 部 是 
以 一 种 非常 随意 的 方式 进行 定义 的 ， 所 以 在 需要 的 时 候 ， 你 也 可 以 根据 
自己 的 想法 来 修改 这 些 方法 和 函数 。 举 个 例子 ， 除 了 “ 先 修改 已 有 的 
Post 结构 ， 然 后 再 调用 Update 方法 将 更 新 反映 到 数据 库 里 面 * 这 种 更 
新 方法 之 外 ， 你 还 可 以 考虑 直接 将 需要 修改 的 内 容 当 作 参 数 传递 给 
Update 方法 ; 又 或 者 说 ， 你 也 可 以 考虑 创建 更 多 不 同 的 获取 函数 ， 然 
后 通过 特定 的 列 或 者 特定 的 过 滤 占 来 获取 你 想 要 的 帖子 。 


6.3.7 ”一 次 获取 多 篇 帖子 


根据 给 定 的 最 大 帖子 数量 ， 一 次 从 数据 库 里 面 获取 多 篇 帖子 ， 是 
种 非 第 第 见 的 做 法 。 换 句 话 说 ， 程 序 可 以 通过 执行 以 下 命令 ， 从 数据 库 
里 面 获 取 前 十 篇 帖子 ， 并 将 它们 放 入 到 一 个 切片 里 面 : 


posts, _ := Posts(1@) 


代码 清单 6-12 展 示 了 完成 这 一 操作 的 Posts 函数 的 具体 定义 。 











代码 清单 6-12 ”一 次 获取 多 篇 帖子 








func Posts(limit int) (posts []Post, err error) { 
rows, err := Db.Query("select id, content, author from posts limit $1" 
=> limit) 
if err != nil { 
return 


for rows.Next() { 


post := Post{} 
err = rows.Scan(&post.Id, &post.Content, &post.Author) 
if err != nil { 
return 
} 
posts = append(posts, post) 


rows.Close() 
return 








Posts 函数 使 用 了 sql1.DB 结构 的 Query 方法 来 执行 查询 ， 这 个 方 
法 会 返回 一 个 Rows 接口 。Rows 接口 是 一 个 迭代 器 ， 程 序 可 以 通过 重复 
调用 它 的 Next 方法 来 对 其 进行 迭代 并 获得 相应 的 sql.Row ; 当 所 有 行 
都 被 迭代 完毕 时 ，Next 方法 将 返回 io.EOF 作为 结果 。 


Posts 函数 在 每 次 进行 迭代 的 时 候 都 会 创建 一 个 Post 结构 ， 并 将 
行 包 含 的 数据 扫描 到 结构 里 面 ， 然 后 再 将 这 个 结构 退 加 到 posts 切片 的 
末尾 。 P Posts 函数 就 会 将 这 个 包含 了 多 
个 Post 结构 的 posts 切片 返回 给 调用 者 。 


6.4 Go 与 SQL 的 关系 


关系 数据 库 之 所 以 能 够 成 为 一 种 流行 的 数据 存储 手段 ， 其 中 一 个 原 
因 就 是 它 可 以 在 表 与 表 之 间 建 立 关 系 ， 从 而 使 不 同 的 数据 能 够 以 一 种 一 
致 且 易 于 理解 的 方式 互相 进行 关联 。 基 本 上 ， 有 4 种 方法 可 以 把 一 项 记 
录 与 其 他 记录 关联 起 来 : 





。 一 对 一 关联 ， 也 被 称 为 “有 一 个 ”(has one) 关系 ， 比 如 一 个 用 户 必 
然 会 拥有 一 个 个 人 简介 ; 

e 一 对 多 关联 ， 也 被 称 为 “有 多 个 ”(has many) 关系 ， 比 如 一 个 用 户 
可 能 会 拥有 多 篇 论坛 帖子 ; 

。 多 对 一 关联 ， 也 被 称 为 “属于 ”(belongs to) 关系 ， 比 如 多 篇 论坛 
帖子 可 能 会 同属 于 某 一 个 用 户 ; 

。 多 对 多 关联 ， 比如 一 个 用 户 可 能 会 参与 论坛 里 面 多 篇 帖子 的 讨 
论 ， 而 一 篇 帖子 里 面 也 会 有 多 个 用 户 在 发 表 评论 。 





在 前 面 的 内 容 中 ， 我 们 已 经 学 习 了 如 何 对 单个 数据 库 表 执 行 标 准 的 
CRUD 操 作 ， 但 我 们 还 不 知道 如 何 才 能 对 两 个 相关 联 的 表 执 行 相同 的 操 
作 。 因 此 ， 在 这 一 节 ， 我 们 将 要 学 习 如 何 通 过 一 对 多 关系 为 一 篇 论坛 帖 
子 构建 多 篇 评论 。 与 此 同时 ， 因 为 一 对 多 关系 跟 多 对 一 天 系 实际 上 就 古 
一 体 两 面 的 两 个 东西 ， 所 以 除了 一 对 多 关系 之 外 ， 我 们 还 会 学 习 如 何 使 
用 多 对 一 关系 。 


6.4.1 设置 数据 库 
在 正式 开始 之 前 ， 我 们 需要 再 次 对 数据 库 进行 设置 ， 不 过 跟 上 次 只 





创建 一 个 表 的 做 法 不 同 ， 这 一 次 我 们 将 会 创建 两 个 表 。 此 外 ， 这 次 设置 
需要 用 到 的 命令 跟 上 一 次 设置 使 用 的 命令 完全 一 样 ， 只 是 被 执行 的 
setup. sql 脚本 跟 之 前 的 有 所 不 同 ， 代 人 码 清 单 6-13 展 示 了 新 脚本 的 具体 

















代码 清 





6-13 fil 


= 





建 两 个 相关 联 的 表 











drop table posts cascade if exists; 
drop table comments if exists; 


create table posts ( 
id serial primary key, 
content text, 
author varchar(255) 

); 


create table comments ( 

id serial primary key, 

content text, 

author varchar(255), 

post_id integer references posts(id) 


); 





这 次 的 脚本 除了 会 创建 posts 表 之 外 ， 还 会 创建 comments 

K, comments 表 的 大 部 分 列 都 跟 posts 表 一 样 ， 主 要 区 别 在 于 
comments 表 多 了 一 个 额外 的 post_id 列 : 这 个 post_id 会 作为 外 键 

(foreign key) ， 对 posts 表 的 主键 id 进行 引用 。 此 外 ， 因 为 posts 表 
和 comments 表现 在 已 经 通过 主键 和 外 键 建立 起 了 关联 ， 所 以 用 户 在 删 
除 posts 表 的 同时 也 需要 将 comments 表 一 并 删除 ;否则 ， 由 于 
comments 表 对 posts 表 的 依赖 关系 ， 删 除 posts 表 这 一 操作 将 无 法 正 
常 执行 。 


设置 好 相应 的 数据 库 表 之 后 ， 现 在 让 我 们 来 看 看 如 何 使 用 Go 语言 
实现 一 对 多 以 及 多 对 一 关系 。 代 码 清 单 6-14 展 示 了 有 具体 的 实现 代码 ， 这 
些 代码 都 存储 在 一 个 名 为 store .go 的 文件 里 面 。 









































代码 清单 6-14 ”使 用 Go 语言 实现 一 对 多 以 及 多 对 一 关系 





package main 


import ( 
"database/sql" 
"errors" 
"fmt" 
_ "github.com/1lib/pq" 
) 


type Post struct { 
Id int 
Content string 
Author string 
Comments []Comment 


} 


type Comment struct { 
Id int 
Content string 
Author string 
Post *Post 


} 


var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
wsslmode=disable") 
if err != nil { 
panic(err) 
} 
} 


func (comment *Comment) Create() (err error) { @ 
if comment.Post == nil { 
err = errors.New("Post not found") 
return 


} 


err = Db.QueryRow("insert into comments (content, author, post_id) 
values ($1, $2, $3) returning id", comment.Content, comment.Author, 
=» comment .Post.Id).Scan(&comment.Id) 

return 


} 


func GetPost(id int) (post Post, err error) { 
post = Post{} 
post.Comments = [ ]Comment{} 
err = Db.QueryRow("select id, content, author from posts where id = 
m1", id).Scan(&post.Id, &post.Content, &post.Author) 


rows, err := Db.Query("select id, content, author from comments") 
if err != nil { 
return 
} 
for rows.Next() { 
comment := Comment{Post: &post} 
err = rows.Scan(&comment.Id, &comment.Content, &comment .Author) 
if err != nil { 
return 


} 


post.Comments = append(post.Comments, comment) 
} 
rows.Close() 
return 


} 


func (post *Post) Create() (err error) { 
err = Db.QueryRow( "insert into posts (content, author) values ($1, $2) 
returning id", post.Content, post.Author).Scan(&post.Id) 
return 


} 


func main() { 
post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
post.Create() 


comment := Comment{Content: "Good post!", Author: "Joe", Post: &post} 
comment .Create() 
readPost, _ := GetPost(post.Id) @ 


fmt .Println(readPost ) 
fmt.Println(readPost.Comments) © 
fmt.Println(readPost.Comments[@].Post) @ 


} 


pt 


@ 创建 一 条 评论 
© {1 Hello World! Sau Sheong [{1 Good post! Joe 0xc20802a1c0}]} 
@ [{1 Goodpost! Joe0xc20802a1c0} 


@ &{1 Hello World! Sau Sheong [{1 Good post! Joe 0xc20802a1c0}]} 


6.4.2 一 对 多 关系 


我 们 首先 需要 考虑 的 是 如 何 使 用 Post 和 Comment 这 两 个 结构 来 构 
建 一 对 多 关系 : 


type Post struct { 
Id int 
Content string 
Author string 
Comments [ ]Comment 


} 


type Comment struct { 
Id int 


Content string 
Author string 
Post *Post 





TER, Post 结构 新 增 了 一 个 Comments 字段 ， 这 个 字段 是 一 个 由 任 
意 多 个 Comment 结构 组 成 的 切片 ， 与 此 同时 ，Comment 结构 也 新 增 了 一 
个 Post 字段 ， 这 个 字段 是 一 个 指向 Post 结构 的 指针 。 初 看 上 去 ， 程 序 
似乎 会 把 多 个 Comment 结构 存储 到 一 个 Post 结构 里 面 ， 然 后 让 


Comment 结构 通过 指针 引用 Post 结构 。 但 是 实际 上 ， 因 为 切片 也 是 一 
个 指 癌 数组 的 指针 ， 所 以 Post 结构 和 Comment 结构 在 构建 关系 时 使 用 
的 都 是 指针 : 这 种 做 法 可 以 确保 程序 获取 到 的 都 是 同一 个 Post 结构 或 
者 Comment 结构 ， 而 不 是 这 些 结构 的 副本 。 





在 设 定好 Post 结构 和 Comment 结构 之 间 的 关系 之 后 ， 我 们 接 下 来 
要 考 碟 的 就 是 如 何 实际 地 构建 这 些 关 系 。 正 如 前 面 所 说 ， 一 对 多 关系 实 
际 上 就 是 多 对 一 关系 ， 所 以 这 两 个 结构 在 定义 一 对 多 关系 的 同时 ， 也 害 
义 了 多 对 一 关系 。 当 程序 创建 一 条 新 评论 的 时 候 ， 它 就 会 在 评论 和 被 评 
论 的 帖子 之 间 建 并 起 以 上 提 到 的 这 两 种 关系 : 


comment := Comment{Content: "Good post!", Author: "Joe", Post: &post} 
comment .Create() 





跟 之 前 的 做 法 一 样 ， 程 序 首先 会 创建 一 个 Comment 结构 ， 然 后 通过 
调用 该 结构 的 Create 方法 来 创建 评论 ， 并 厌 此 建立 起 评论 与 帖子 之 间 
的 关系 。 代 码 清单 6-15 展 示 了 Comment 结构 的 Create 方法 的 具体 定 
Me 














代码 清单 6-15 ”创建 评论 ， 并 建立 评论 与 帖子 之 间 的 关系 














func (comment *Comment) Create() (err error) { 


if comment.Post == nil { 
err = errors.New("Post not found") 
return 


err = Db.QueryRow("insert into comments (content, author, post_id) 
values ($1, $2, $3) returning id", comment.Content, comment.Author, 
=» comment .Post.Id).Scan(&comment.Id) 

return 


[L CR 


在 为 评论 和 帖子 建立 关系 之 前 ，Create 方法 会 先 检 查 给 定 的 帖子 
是 否 存 在 ， 并 在 帖子 不 存在 时 返回 一 个 错误 。 除 了 “通过 post_id 建立 
关系 ”这 一 细节 没有 提 及 之 外 ，Create 方法 的 其 余 代 码 的 行为 跟 我 们 之 
前 描述 的 一 模 一 样 。 


在 建立 起 评论 和 帖子 之 间 的 关系 之 后 ， 我 们 接 下 来 要 考虑 的 就 是 如 
何 修改 GetPost 函数 ， 让 它 可 以 在 获取 帖子 的 同时 ， 一 并 获取 与 帖子 相 
关联 的 评论 。 比 如 说 ， 程 序 在 执行 完 以 下 代码 之 后 ， 应 该 可 以 通过 访问 
readPost 变量 的 Comments 字段 来 查看 帖子 已 有 的 评论 : 


readPost, _ := GetPost(post.Id) 


代码 清单 6-16 展 示 了 修改 之 后 的 GetPost 函数 的 定义 。 





























代码 清单 6-16 “获取 帖子 及 其 评论 

















func GetPost(id int) (post Post, err error) { 
post = Post{} 
post.Comments = [ ]Comment{} 
err = Db.QueryRow("select id, content, author from posts where id = 
ww$1", id).Scan(&post.Id, &post.Content, &post.Author) 


rows, err := Db.Query("select id, content, author from comments where 
wpost id = $1", id) 
if err != nil { 
return 
} 
for rows.Next() { 
comment := Comment{Post: &post} 
err = rows.Scan(&comment.Id, &comment.Content, &comment.Author) 
if err != nil { 
return 


} 


post.Comments = append(post.Comments, comment) 


rows.Close() 
return 


} 





GetPost 函数 首先 会 初始 化 Post 结构 中 的 Comments 字段 ， 并 从 数 





据 库 里 面 获取 帖子 的 具体 数据 。 在 此 之 后 ， 程 序 会 从 数据 库 里 面 获取 与 
当前 帖子 关联 的 所 有 评论 ， 接 着 迭代 这 些 评论 ， 为 每 个 评论 都 创建 一 
个 Comment 结构 并 将 其 追加 到 Comments 切片 里 面 。 当 所 有 评论 都 被 挝 
代 完 毕 之 后 ，GetPost 函数 就 会 将 包含 了 评论 的 Post 结构 返回 给 调用 
者 。 正 如 上 述 内 容 所 示 ， 在 多 个 表 之 间 建 立 关 系 并 不 困难 ， 但 是 这 一 行 
为 在 Web 应 用 变 得 越 来 越 庞大 的 同时 就 会 变 得 越 来 越 麻烦 。 为 了 解决 这 
个 问题 ， 我 们 将 在 接 下 来 的 一 节 中 学 习 如 何 通过 关系 映射 器 来 简化 关系 
的 构建 方法 。 














虽然 本 节 展 示 了 所 有 数据 库 应 用 都 会 用 到 的 CRUD 操 作 ， 但 这 些 操 
作 充 其 量 只 是 使 用 Go 访问 SQL 数据 库 的 基本 知识 ， 如 果 你 有 兴趣 了 解 更 
多 相关 的 知识 ， 那 么 可 以 去 读 一 下 Go 的 官方 文档 。 


6.5 GoS KARIN AS 


初 看 上 去 ， 将 数据 存储 到 关系 数据 库 里 面 似乎 并 不 是 一 件 轻松 的 事 
情 ， 有 非常 多 的 工作 要 做 。 对 不 少 语言 来 说 ， 这 一 判断 是 正确 的 ， 然 而 
在 实际 中 ，SQL 与 应 用 之 间 通 常 存在 着 一 些 第 三 方 库 ， 这 些 库 在 面 同 对 
象 编 程 语言 中 一 般 称 为 对 象 -关系 映射 器 (object-relational mapper, 
ORM) 。 诸 如 Java 的 Hibernate 以 及 Ruby 的 ActiveRecord 之 类 的 ORM 都 会 
把 关系 数据 库 中 的 表 映 射 为 编程 语言 中 的 对 象 ， 但 为 表 创建 映 射 并 不 是 
面向 对 象 编程 语言 的 特权 ， 很 多 其 他 编程 语言 也 拥有 类 似 的 映射 器 ， 比 
ui, Scala Activatet£Z2, Haskell4 Groundhog | . 








Go 同样 也 拥有 类 似 的 关系 映射 器 (relational mapper) ， 本 节 接 下 
来 将 介绍 其 中 一 些 映 射 器 (因为 ORM 这 一 术语 对 于 Go 来 说 并 不 是 特别 
准确 ， 所 以 我 们 将 使 用 “关系 映射 器 ”而 不 是 “ORM” 来 称呼 接 下 来 提 到 的 
Go 映射 器 ) o 


6.5.1 Sqlx 


Sqlx 是 一 个 第 三 方 库 ， 它 为 database/sql 包 提 供 了 一 系列 非常 有 
用 的 扩展 功能 。 因 为 Sqlx 和 database/sql 包 使 用 的 是 相同 的 接口 ， 所 
以 Sqlx 能 够 很 好 地 兼容 使 用 database/sql 包 的 程序 ， 除 此 之 外 ，Sqlx 
还 提供 了 以 下 这 些 额外 的 功能 : 





。 通过 结构 标签 (struct tag) 将 数据 库 记 录 《〈 即 行 ) 封装 为 结构 、 映 
WREAU; 
。 为 预 处 理 语句 提供 具名 参数 文 持 。 


代码 清单 6-17 展 示 了 如 何 使 用 Sqlx 及 其 提供 的 StructScan 方法 来 
对 论坛 程序 进行 简化 。 另 外 别 秋 了， 在 使 用 Sqlx 库 之 前 ， 需 要 先 通过 执 
行 以 下 命令 来 获取 这 个 库 : 





go get "github.com/jmoiron/sqlx" 

















代码 清单 6-17 使 用 Sqlx 重新 实现 论坛 程 





机 




















package main 


import ( 
"fmt" 
"github.com/jmoiron/sqlx" 


_ "github.com/lib/pq" 
) 


type Post struct { 
Id int 
Content string 
AuthorName string db: author 


} 


var Db *sqlx.DB 


func init() { 
var err error 
Db, err = sqlx.Open("postgres", "user=gwp dbname=gwp password=gwp 


=»sslmode=disable" ) 


if err != nil { 
panic(err) 
} 
} 


func GetPost(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRowx( "select id, content, author from posts where id = 


$1", id).StructScan(&post) 


if err != nil { 
return 
} 


return 


} 


func (post *Post) Create() (err error) { 
err = Db.QueryRow("insert into posts (content, author) values ($1, $2) 
returning id", post.Content, post.AuthorName) .Scan(&post.Id) 
return 


} 


func main() { 
post := Post{Content: "Hello World!", AuthorName: "Sau Sheong"} 
post.Create() 
fmt.Println(post) @ 





@ {1 Hello World! Sau Sheong}} 


代码 清单 中 的 加 粗 代 码 展示 了 使 用 Sqlx 与 使 用 database/sql 之 间 
的 区 别 ， 而 其 余 的 则 是 一 些 我 们 之 前 已 经 看 到 过 的 代码 。 首 先 ， 程 序 现 
在 不 再 导入 database/sql 包 ， 而 是 导入 github.com/jmoiron/sqlx 





包 。 在 默认 情况 下 ，StructScan 会 根据 结构 字段 名 的 英文 小 写 体 ， 将 
结构 中 的 字段 映射 至 表 中 的 列 。 为 了 省 示 如 何 将 指定 的 表 列 映射 至 指定 
的 结构 字段 ， 代 码 清单 6-17 将 原来 的 Author 字段 修改 成 了 AuthorName 
字段 ， 然 后 通过 结构 标签 来 指示 Sqlx 应 该 从 author 列 里 面 获取 
AuthorName 字段 的 数据 。 本 书 将 在 第 7 章 对 结构 标签 做 进一步 的 说 

明 。 








程序 现在 也 会 使 用 sqlx .DB 结构 来 代替 之 前 的 sql.DB 结构 ， 这 两 
种 结构 非常 相似 ， 只 不 过 sqlx.DB 包含 了 诸如 Queryx 以 及 QueryRowx 
等 额外 的 方法 。 


修改 之 后 的 GetPost 函数 也 使 用 QueryRowx 代 蔡 了 之 前 的 
QueryRow 。QueryRowx 在 执行 之 后 将 返回 Rowx 结构 ， 这 种 结构 拥 
有 StructScan 方法 ， 该 方法 可 以 将 列 上 自动 地 映射 到 相应 的 字段 里 面 。 
另 一 方面 ， 对 于 Create 方法 ， 我 们 还 是 跟 之 前 一 样 ， 使 用 QueryRow 方 
法 进行 查询 。 


除了 这 里 提 到 的 特性 之 外 ，Sqlx 还 拥有 其 他 一 些 有 趣 的 特性 ， 感 兴 
趣 的 读者 可 以 通过 访问 Sqlx 的 GitHub 页 面 来 了 解 : 
https://github.com/jmoiron/sqlx. 





Sqlx 是 一 个 有 趣 并 且 有 用 的 database/sql 扩展 ， 但 它 支 持 的 特性 
并 不 多 。 与 此 相反 ， 我 们 接 下 来 要 学 习 的 Gorm 库 不 仅 把 database/sq1l1 
包 隐 藏 了 起 来 ， 它 还 提供 了 一 个 完整 且 强 大 的 ORM 机 制 来 代 蔡 
database/sql 包 。 


6.5.2 Gorm 


Gorm 的 开发 者 声称 Gorm 是 最 棒 的 Go 语言 ORM， 他 们 的 确 所 言 非 
虚 。Gorm 是 “Go-ORM" 一 词 的 缩写 ， 这 个 项 目 是 一 个 使 用 Go 实现 的 
ORM， 它 遵循 的 是 与 Ruby 的 ActiveRecord 以 及 Java 的 Hibernate 一 样 的 道 
路 。 更 确切 地 说 ，Gorm 遵 循 的 是 数据 映射 器 模式 〈Data-Mapper 
pattern) ， 该 模式 通过 提供 映射 器 来 将 数据 库 中 的 数据 映射 为 结构 。 
(在 6.3 节 介绍 关系 数据 库 时 ， 使 用 的 就 是 ActiveRecord 模 式 。) 


Gorm 的 能 力 非 第 强大 ， 它 允许 程 友 员 定义 关系 、 实 施 数据 迁移 、 
串联 多 个 碍 询 以 及 执行 其 他 很 多 高 级 的 操作 。 除 此 之 外 ，Gorm 还 能 够 
设置 回调 函数 ， 这 些 函 数 可 以 在 特定 的 数据 事件 发 生 时 执行 。 因 为 详尽 
地 描述 Gorm 的 各 个 特性 可 能 会 花 挥 整整 一 章 的 篇 幅 ， 所 以 我 们 在 这 里 
只 会 讨论 它 的 基本 特性 。 代 码 清单 6-18 展 示 了 使 用 Gorm 重 新 实现 论坛 程 
序 的 方法 ， 跟 之 前 一 样 ， 这 次 的 代码 也 是 存储 在 store .go 文件 里 面 。 





























代码 清单 6-18 ”使 用 Gorm 实 现 论 坛 程序 























package main 


import ( 
"fmt" 
"github.com/jinzhu/gorm" 
_ "github.com/lib/pq" 
"time" 


) 


type Post struct { 
Id int 
Content string 
Author string `sql:"not null" 
Comments []Comment 
CreatedAt time.Time 


} 


type Comment struct { 
Id int 
Content string 


Author string ~sql:"not null" 
PostId int ~sql:"index"” 
CreatedAt time.Time 


} 
var Db gorm.DB 


func init() { 
var err error 
Db, err = gorm.Open("postgres", "user=gwp dbname=gwp password=gwp 
æsslmode=disable") 
if err != nil { 
panic(err) 
} 
Db.AutoMigrate(&Post{}, &Comment{}) 
} 


func main() { 


post := Post{Content: "Hello World!", Author: "Sau Sheong"} @ 
fmt .Println(post) 


Db.Create(&post) @ 
fmt.Println(post) © 


comment := Comment{Content: "Good post!", Author: "Joe"} @ 
Db.Model(&post) .Association( "Comments" ) .Append( comment ) 


var readPost Post 
Db.Where("author = $1", "Sau Sheong").First(&readPost) © 
var comments [ ]Comment 
Db.Model(&readPost) .Related(&comments ) 
fmt.Println(comments[@]) © 
} 





@ {0 Hello World! Sau Sheong [] 0001-01-01 00:00:00 +0000 UTC} 


O 创建 一 篇 帖子 


© {1 Hello World! Sau Sheong [] 2015-04-12 11:38:50.91815604 
+0800 SGT} 


O 添加 一 条 评论 
O 通过 帖子 获取 评论 
@ {1 Good post! Joe 1 2015-04-13 11:38:50.920377 +0800 SGT} 


这 个 新 程序 创建 数据 库 句柄 的 方法 跟 我 们 之 前 创建 数据 库 句 柄 的 方 
法 基本 相同 。 男 外 需要 注意 的 一 点 是 ， 因 为 Gorm 可 以 通过 目 动 数据 迁 
移 特性 来 创建 所 需 的 数据 库 表 ， 并 在 用 户 修 改 相 应 的 结构 时 目 动 对 数据 
库 表 进行 更 新 ， 所 以 这 个 程序 无 需 使 用 setup.sq1 文件 来 设置 数据 库 
R: 当 我 们 运行 这 个 程序 时 ， 程 序 所 需 的 数据 库 表 就 会 目 动 生成 。 为 了 
正确 地 运行 这 个 程序 ， 并 让 程序 能 够 正常 地 创建 数据 库 表 ， 我 们 在 执行 
这 个 程序 之 前 必须 先 将 之 前 创建 的 数据 库 表 全 部 删除 : 











func init() { 
var err error 
Db, err = gorm.Open("postgres", "user=gwp dbname=gwp password=gwp sslm 
ode=disable") 
if err != nil { 
panic(err) 


Db.AutoMigrate(&Post{}, &Comment{}) 





负责 执行 数据 迁移 操作 的 AutoMigrate 方法 是 一 个 变 长 参数 方 
法 ， 这 种 类 型 的 方法 和 函数 能 够 接受 一 个 或 多 个 参数 作为 输入 。 在 上 面 
展示 的 代码 中 ，AutoMigrate 方法 接受 的 是 Post 结构 和 Comment 结 
iM. mT ASABE RENAE, SAHRA Bese 
时 候 ，Gorm 残 会 自动 在 数据 库 表 里 面 添加 相应 的 新 列 。 








上 面 的 Gorm 程 序 使 用 了 下 和 面 所 示 的 Comment 结构 : 


type Comment struct { 
Id int 
Content string 
Author string ~sql:"not null" 


PostId int 
CreatedAt time.Time 





Comment 结构 里 面 出现 了 一 个 类 型 为 time.Time 的 CreatedAt 字 
段 ， 包 含 这 样 一 个 字段 意味 着 Gorm 每 次 在 数据 库 里 创建 一 条 新 记录 的 
时 候 ， 都 会 自动 对 这 个 字段 进行 设置 。 


此 外 ，Comment 结构 的 其 中 一 些 字段 还 用 到 了 结构 标签 ， 以 此 来 指 
示 Gorm 应 该 如 何 创建 和 映射 相应 的 字段 。 比 如 ，Comment 结构 的 
Author 字段 就 使 用 了 结构 标签 'sql: "not null"' ， 以 此 来 告知 
Gorm， 该 字段 对 应 列 的 值 不 能 为 null 。 


跟前 面 展示 过 的 程序 的 男 一 个 不 同 之 处 在 于 ， 这 个 程序 没有 
在 Comment 结构 里 设置 Post 字段 ， 而 是 设置 了 一 个 PostId 字段 。 
Gorm 会 自动 把 这 种 格式 的 字段 看 作 是 外 键 ， 并 创建 所 需 的 关系 。 


在 了 解 了 Post 结构 和 Comment 结构 的 新 定义 之 后 ， 现 在 ， 让 我 们 
来 看 看 程序 是 如 何 创建 并 获取 帖子 及 其 评论 的 。 首 先 ， 程 序 会 使 用 以 下 
语句 来 创建 新 的 帖子 : 





post := Post{Content: "Hello World!", Author: "Sau Sheong"} 
Db.Create(&post) 











这 段 代 码 没 有 什么 难民 的 地 方 ， 它 跟 之 前 展示 过 的 代码 的 最 主要 区 
列 在 于 一 一 程序 这 次 遵循 了 数据 映射 右 模 式 : 它 在 创建 帖子 时 会 使 用 数 
据 库 句 柄 gorm.DB 作为 构造 器 ， 而 不 是 像 之 前 遵循 ActiveRecord 模 式 时 
那样 ， 通 过 直接 调用 Post 结构 自 有 的 Create 方法 来 创建 帖子 。 





如 果 直 接 查 看 数据 库 内 部 ， 应 该 会 看 到 created_at 这 个 时 间 惟 列 
在 帖子 创建 出 来 的 同时 已 经 自动 被 设置 好 了 。 





在 创建 出 帖子 之 后 ， 程 序 使 用 了 以 下 语句 来 为 帖子 添加 评论 : 


comment := Comment{Content: "Good post!", Author: "Joe"} 
Db.Model(&post).Association("Comments").Append(comment) 





这 段 代 码 会 先 创 建 出 一 条 评论 ， 然 后 通过 串联 Model 方 
法 、Association 方法 和 Append 方法 来 将 评论 添加 到 帖子 里 面 。 注 
意 ， 在 创建 评论 的 过 程 中 ， 我 们 无 需 手 动 对 Comment 结构 的 PostId F 
段 执 行 任何 操作 。 


最 后 ， 程 序 使 用 了 以 下 代码 来 获取 帖子 及 其 评论 : 


var readPost Post 
Db.Where("author = $1", "Sau Sheong").First(&readPost) 
var comments [ ]Comment 


Db .Model(&readPost) .Related(&comments ) 





这 段 代 码 跟 之 前 展示 过 的 代码 有 些 类 似 ， 它 使 用 了 gorm.DB 的 
Where 方法 来 查找 第 一 条 作者 名 为 "Sau Sheong" 的 记录 ， 并 将 这 条 记 
录 存 储 在 了 readPost 变量 里 面 ， 而 这 条 记录 就 是 我 们 刚刚 创建 的 帖 





子 。 之 后 ， 程 序 首先 调用 Model 方法 获取 帖子 的 模型 ， 接 着 调 
用 Related 方法 获取 帖子 的 评论 ， 并 在 最 后 将 这 些 评论 存储 
到 comments 变量 里 面 。 


正如 之 前 所 说 ， 本 节 展 示 的 特性 只 是 Gorm 这 个 ORM 库 众多 特性 的 
一 小 部 分 ， 如 果 你 对 这 个 库 感 兴趣 ， 可 以 通过 
https://github.com/jinzhu/gorm 了 人 解 更 多 相关 信息 。 


Gorm 并 不 是 Go 语言 唯一 的 ORM 库 。 除 Gorm 之 外 ，Go 还 拥有 不 少 
同样 具备 众多 特性 的 ORM 库 ， 比 如 ，Beego 的 ORM 库 以 及 
GORP (GORP 并 不 完全 是 一 个 ORM， 但 它 与 ORM 相 去 不 远 ) 。 


在 本 章 中 ， 我 们 了 解 了 构建 Web 应 用 所 需 的 基本 组 件 ， 而 在 接 下 来 
的 一 草 中 ， 我 们 将 要 开始 讨论 如 何 构建 Web 服 务 。 


6.6 小结 








。 通过 使 用 结构 将 数据 存储 在 内 存 里 面 ， 以 此 来 构建 数据 缓存 机 制 并 
提高 啊 应 速度 。 

。 通过 使 用 CSV 或 者 gob 二 进 制 格式 将 数据 存储 在 文件 里 面 ， 可 以 对 
用 户 提 交 的 文件 进行 处 理 ， 或 者 为 缓存 数据 提供 备份 。 

。 通过 使 用 database/sql 包 ， 可 以 对 关系 数据 库 执 行 CRUD 操 作 ， 
并 在 不 同 的 数据 之 间 建 立 起 相应 的 关系 。 

。 通过 Sqlx 和 Gorm 这 样 的 第 三 方 数据 访问 库 ， 可 以 使 用 威力 更 强大 的 
工具 去 操纵 数据 库 中 的 数据 。 





[1] 有 序 关机 指 的 是 等 到 所 有 任务 都 执行 完毕 之 后 ， 以 有 组 织 的 方式 关 
闭 计算 机 系统 ， 这 种 关机 可 以 确保 系统 在 重启 之 后 不 会 丢失 任何 进度 或 
者 数据 。—_ 译 者 注 











第 二 部 分 ”实战 演练 


在 上 一 个 部 分 ， 我 们 学 习 了 如 何 编写 基本 的 服务 器 端 Web 应 用 ， 但 
这 些 知识 只 不 过 是 Web 应 用 开发 中 的 沧海 一 桶 。 绝 大 多 数 现代 化 的 Web 
应 用 早已 超越 了 简单 的 请 求 - 啊 应 模型 ， 并 以 多 种 不 同 的 形式 在 不 断 地 
演进 当中 。 比 如 ， 单 页 应 用 〈Single Page Application, SPA) 和 移动 应 
用 (无论 是 原生 的 还 是 混合 的 ) 就 能 够 在 获取 Web 服 务 中 的 数据 的 同 
时 ， 人 快速 地 与 用 户 进行 交互 。 





在 本 书 的 最 后 一 部 分 ， 我 们 将 会 学 习 如 何 使 用 Go 语言 编写 能 够 为 
单 页 应 用 、 移 动 应 用 以 及 其 他 Web 应 用 提供 服务 的 Web 服 务 。 除 此 之 
外 ， 我 们 还 会 深入 了 解 Go 语言 强大 的 并 发 特性 ， 并 学 习 如 何 通过 并 发 
提高 Web 应 用 的 性 能 。 之 后 ， 我 们 会 了 解 Go 提供 的 几 个 测试 工具 ， 并 使 
用 这 些 工 具 对 Web 应 用 进行 测试 。 


在 本 书 的 最 后 ， 我 们 将 会 学 习 如 何以 多 种 不 同 的 方式 部 普 Web 应 
用 ， 其 中 包括 只 需要 将 可 执行 二 进 制 文件 复制 到 目标 服务 器 的 简单 部 闭 
方法 ， 以 及 需要 执行 一 系列 步骤 才能 将 Web 应 用 推送 到 云端 的 高 级 部 普 
FIR 0 





第 7 章 Go Web 服 务 


本 章 主要 内 容 


。 使 用 REST 风 格 的 Web 服 务 
。 使 用 Go 创建 和 分 析 XML 
。 使 用 Go 创建 和 分 析 JSON 
。 编写 Go Web 服 务 


正如 本 书 第 1 章 所 言 ，Web 服 务 就 是 一 个 向 其 他 软件 程序 提供 服务 
的 程序 。 本 章 将 扩展 这 一 定义 ， 并 展示 如 何 使 用 Go 语言 来 编写 或 使 用 
Web 服 务 。 因 为 XML 和 JSON 是 Web 服务 最 常 使 用 的 数据 格式 ， 所 以 我 
们 首先 会 学 习 如 何 创 建 以 及 分 析 这 两 种 数据 格式 ， 接 着 我 们 将 会 讨论 
SOAP 风 格 的 服务 以 及 REST 风 格 的 服务 ， 并 在 之 后 学 习 如 何 创建 一 个 使 
用 JSON 传 输 数 据 的 简单 的 Web 服 务 。 


7.1 Web 服 务 简介 


通过 Go 语言 编写 的 Web 服 务 同 其 他 Web 服 务 或 应 用 提供 服务 和 数 
据 ， 是 Go 语言 的 一 种 常见 的 用 法 。 所 谓 的 Web 服 务 ， 一 言 以 菩 之 ， 束 是 
一 种 与 其 他 软件 程序 进行 交互 的 软件 程序 。 这 也 就 是 说 ，Web 服 务 的 终 
端 用 户 (end user) 不 是 人 类 ， 而 是 软件 程序 。 正 如 “Web 服 务 ” 这 一 名 字 
所 暗示 的 那样 ， 这 种 软件 程序 是 通过 HTTP 进 行 通信 的 ， 如 图 7-1 所 示 。 





用 户 浏览 器 Web 应 用 
— 

32 Ha HTTP =a 

Lee 

Web 应 用 Web 服 务 

















图 7-1 Web 应 用 与 Web 服 务 的 不 同 之 处 





有 趣 的 是 ， 虽 然 web 应 用 并 没有 一 个 确切 的 定义 ， 但 Web 服 务 的 定 
义 却 可 以 在 W3C 工 作 组 发 布 的 《Web 服 务 架构 》 (Web Service 
Architecture) 文档 中 找到 : 


Web 服 务 是 一 个 软件 系统 ， 它 的 目的 是 为 网 络 上 进行 的 可 互 操作 机 器 间 
交互 (interoperable machine-to-machine interaction) 提供 文 持 。 每 个 Web 服 务 
都 拥有 一 套 自己 的 接口 ， 这 些 接 口 由 一 种 名 为 Web 服 务 描述 语言 (web 
service description language, WSDL) 的 机 器 可 处 理 格式 描述 。 其 他 系统 需 
要 根据 Web 服 务 的 描述 ， 使 用 SOAP 消 息 与 Web 服 务 交 互 。 为 了 与 其 他 Web 
相关 标准 实现 协作 ，SOAP 消 息 通 常会 被 序列 化 为 XML 并 通过 HTTP 传 输 。 















































一 《Web 服 务 架 构 》，2004 年 2 月 11 日 





从 这 一 定义 来 看 ， 似 乎 所 有 Web 服 务 都 应 该 基于 SOAP 来 实现 ， 但 
实际 中 却 存 在 着 多 种 不 同类 型 的 Web 服 务 ， 其 中 包括 基于 SOAP 的 、 基 
于 REST 的 以 及 基于 XML-RPC 的 ， 而 基于 REST 的 和 基于 SOAP 的 Web 服 
务 又 是 其 中 最 为 流行 的 。 企 业 级 系统 大 多 数 都 是 基于 SOAP 的 Web 服 务 
实现 的 ， 而 公开 可 访问 的 Web 服 务 则 更 青睐 基于 REST 的 Web 服 务 ， 本 
章 稍 后 将 会 对 此 进行 讨论 。 








基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 都 能 够 完成 相同 的 功 
能 ， 但 它们 各 自 也 拥有 不 同 的 长 处 。 基 于 SOAP 的 Web 服 务 出 现 的 时 间 
较 早 ，W3C 工 作 组 已 经 对 其 进行 了 标准 化 ， 与 之 相关 的 文档 和 资料 也 非 
常 丰富 。 除 此 之 外 ， 很 多 企业 都 对 基于 SOAP 的 Web 服 务 提供 了 强 有 力 
的 支持 ， 并 且 基 于 SOAP 的 Web 服 务 还 拥有 数量 颇 丰 的 扩展 可 用 (因为 
这 些 扩展 的 名 字 绝 大 多 数 都 是 像 WS-Security 和 WS-Addressing 这 样 以 WS 











为 前 缀 的， 所 以 这 些 扩展 被 统称 为 WS-*) 。 基 于 SOAP 的 服务 不 仅 健 
壮 、 能 够 使 用 WSDL 进 行 明确 的 描述 、 拥 有 内 置 的 错误 处 理 机 制 ， 而 且 
还 可 以 通过 UUDI (Universal Description, Discovery, and Integration, 统 
一 描述 、 发 现 和 集成 ) 《一 种 目录 服务 ) 规范 发 布 。 





在 拥有 以 上 众多 优点 的 同时 ，SOAP 的 缺点 也 是 非常 明显 的 : 它 不 
仅 笨重 ， 而 且 过 于 复杂 。SOAP 的 XML 报 文 可 能 会 变 得 非常 元 长 ， 导 致 
难以 调试 ， 使 用 户 只 能 通过 其 他 工具 对 其 进行 管理 ， 而 基于 SOAP 的 
Web 服 务 可 能 会 因为 额外 的 资源 损耗 而 无 法 高 效 地 运行 。 此 外 ，WSDL 
虽然 在 客户 端 和 服务 器 之 间 提 供 了 坚实 的 契约 ， 但 这 种 契约 有 时 候 也 会 
AE AH ERE: 为 了 对 Web 服 务 进行 更 新 ， 用 户 必须 修改 WSDL， 而 这 
种 修改 又 会 引起 SOAP 客 户 端 发 生变 化 ， 最 终 导致 Web 服 务 的 开发 者 即 
使 在 进行 最 细微 的 修改 时 ， 也 不 得 不 使 用 版 本 锁定 (version lock-in) 以 
防止 发 生意 外 。 


跟 基 于 SOAP 的 Web 服 务 比 起 来 ， 基 于 REST 的 Web 服 务 就 显得 灵活 
多 了 。REST 本 喘 并 不 是 一 种 结构 ， 而 是 一 种 设计 理念 。 很 多 基于 REST 
的 web 服务 都 会 使 用 像 JSON 这 样 较 为 简单 的 数据 格式 而 不 是 XML， 从 
而 使 web 服务 可 以 更 高 效 地 运行 ， 并 且 基 于 REST 的 Web 服 务实 现 起 来 
通常 会 比 基 于 SOAP 的 Web 服 务 简 单 得 多 。 


基于 SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 的 另 一 个 区 别 在 于 ， 
前 者 是 功能 驱动 的 ， 而 后 者 是 数据 驱动 的 。 基 于 SOAP 的 Web 服 务 往往 
是 RPC (Remote Procedure Call， 远 程 过 程 调 用 〉 风格 的 ; 但 是 ， 正 如 
之 前 所 说 ， 基 于 REST 的 Web 服 务 关 注 的 是 资源 ， 而 HTTP 方 法 则 是 对 这 
些 资 源 执行 操作 的 动词 。 








ProgrammableWeb 是 一 个 流行 的 API 检 测 网 站 ， 它 会 对 互联 网 上 公 
开 可 用 的 API 进 行 检测 。 在 编写 本 书 的 时 候 ，ProgrammableWeb 的 数据 
库 搜集 了 12 987 个 公开 可 用 的 API， 其 中 2 061 个 〈 占 比 16%) 为 基于 
SOAP 的 API， 而 6 967 个 ( 占 比 54%) 为 基于 REST 的 API H 。 可 惜 的 
是 ， 因 为 企业 很 少 会 对 外 发 布 与 内 部 Web 服 务 有 关 的 信息 ， 所 以 想 要 调 
查 清 楚 各 种 Web 服 务 在 企业 中 的 使 用 情况 是 非常 困难 的 。 











为 了 满足 不 同 的 需求 ， 很 多 开发 者 和 公司 最 终 还 是 会 同时 使 用 基于 
SOAP 的 Web 服 务 和 基于 REST 的 Web 服 务 。 在 这 种 情况 下 ，SOAP 将 用 
于 实现 内 部 应 用 的 企业 集成 (enterprise integration) ， 而 REST 则 用 于 服 
务 外 部 以 及 第 三 方 的 开发 者 。 这 一 策略 的 优势 在 于 ， 它 最 大 限度 地 利用 
了 REST〔 速 度 快 并 且 构 建 简单 ) 以 及 SOAP〔 安 全 并 且 健 壮 ) 这 两 种 技 
术 的 优点 。 


7.2 ”基于 SOAP 的 Web 服 务 简介 


SOAP 是 一 种 协议 ， 用 于 交换 定义 在 XML 里 面 的 结构 化 数据 ， 它 能 
够 跨越 不 同 的 网 络 协 议 并 在 不 同 的 编程 模型 中 使 用 。SOAP 原 本 是 
Simple Object Access Protocol( 人 简单 对 象 访问 协议 ) 的 首 字 母 缩写 ， 但 
这 实际 上 是 一 个 名 不 符 实 的 名 字 ， 因 为 这 种 协议 处 理 的 并 不 是 对 象 ， 并 
且 时 至 今日 它 也 已 经 不 再 是 一 种 简单 的 协议 了 。 在 最 新 版 的 SOAP 1.2 规 
范 中 ， 这 种 协议 的 官方 名 称 仍然 为 OAP， 但 它 已 经 不 再 代表 Simple 
Object Access Protocol 了 。 











因为 SOAP 不 仅 高 度 结构 化 ， 而 且 还 需要 严格 地 进行 定义 ， 所 以 用 
于 传输 数据 的 XML 可 能 会 变 得 非常 复 杀 。WSDL 是 客户 端 与 服务 器 之 间 
的 契约 ， 它 定义 了 服务 提供 的 功能 以 及 提供 这 些 功 能 的 方式 ， 服 务 的 每 
个 操作 以 及 输入 /输出 都 需要 由 WSDL 明 确 地 定义 。 





虽然 本 章 主 要 关注 的 是 基于 REST 的 Web 服 务 ， 但 出 于 对 比 需 要 ， 
我 们 也 会 了 解 一 下 基于 SOAP 的 Web 服 务 的 运作 机 制 。 


SOAP 会 将 它 的 报 文 内 容 放 入 到 信封 Cenvelope) 里面 ， 信 封 相当 于 
一 个 运输 容器 ， 并 且 它 还 能 够 独立 于 实际 的 数据 传输 方式 存在 。 因 为 本 
书 只 会 对 SOAP Web 服 务 进行 考察 ， 所 以 我 们 将 通过 HTTP 协 议 来 说 明 被 
传输 的 SOAP 报 文 。 





下 面 是 一 个 经 过 简化 的 SOAP 请 求 报 文 示例 : 


POST /GetComment HTTP/1.1 
Host: www.chitchat.com 


Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 
<soap: Envelope 
xmlns:soap="http: //www.w3.org/2001/12/soap-envelope" 
soap: encodingStyle="http: //www.w3.org/2001/12/soap-encoding" > 
<soap:Body xmlns:m="http://www.chitchat.com/forum"> 
<m:GetCommentRequest> 
<m: CommentId>123</m: CommentId> 
</m:GetCommentRequest > 
</soap :Body> 
</soap:Envelope> 





因为 前 面 已 经 介绍 过 HTTP 报 文 的 首部 ， 所 以 这 里 给 出 的 HTTP 首 部 








对 你 来 说 应 该 不 会 感到 陌生 。 需 要 注意 的 是 ，Content-Type 的 值 被 设 
置 成 了 application/soap+xml ， 而 HITP 请 求 的 主体 就 是 SOAP 报 文 
本 号 ， 至 于 SOAP 报 文 的 主体 则 包含 了 请 求 报 文 。 在 这 个 例子 中 ， 报 文 
请 求 的 是 了 为 123 的 评论 





<m:GetCommentRequest> 
<m:CommentId>123</m:CommentId> 
</m:GetCommentRequest > 








这 条 SOAP 报 文 示例 经 过 了 简化 ， 实 际 的 SOAP 请 求 通常 会 复杂 得 
多 。 下 面 展示 的 则 是 一 条 简化 后 的 SOAP 啊 应 报 文 示例 : 








HTTP/1.1 200 OK 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 

<soap: Envelope 

xmlns:soap="http: //www.w3.org/2001/12/soap-envelope" 

soap: encodingStyle="http: //www.w3.org/2001/12/soap-encoding" > 

<soap:Body xmlns:m="http://www.example.org/stock"> 
<m:GetCommentResponse> 


<m:Text>Hello World!</m:Text> 
</m:GetCommentResponse> 
</soap :Body> 
</soap:Envelope> 





跟 请 求 报 文 一 样 ， 啊 应 报 文 也 被 包含 在 了 SOAP 报 文 的 主体 里 面 ， 
它 的 内 容 为 文本 “Hello World!”: 


<m:GetCommentResponse> 
<m:Text>Hello World!</m:Text> 


</m:GetCommentResponse> 





正如 上 面 的 例子 所 示 ， 与 报 文 有 关 的 所 有 数据 都 会 被 包含 在 信封 里 
面 。 对 基于 SOAP 的 Web 服 务 来 说 ， 这 意味 着 它 传输 的 所 有 信息 都 会 被 
包 庄 在 SOAP 信 封 里 面 ， 然 后 再 发 送 。 顺 带 一 提 ， 虽 然 SOAP 1.2 人 允许 通 
过 HTTP 的 GET 方法 发 送 SOAP 报 文 ， 但 大 多 数 基于 SOAP 的 Web 服 务 都 
是 通过 HTTP 的 POST 方法 发 送 SOAP 报 文 的 。 





下 面 展示 的 是 一 个 WSDL 报 文 示例 ， 这 种 报 文 不 仅 详细 ， 而 且 还 很 
见长 ， 即 使 对 简单 的 服务 来 说 也 是 如 此 。 基 于 SOAP 的 Web 服 务 之 所 以 
没有 基于 REST 的 Web 服 务 那么 流行 ， 其 中 一 部 分 原因 就 与 此 有 关 一 -一 
一 个 基于 SOAP 的 Web 服 务 越 复杂 ， 它 对 应 的 WSDL 报 文 就 越 元 长 。 








<?xml version="1.0" encoding="UTF-8"?> 

<definitions name ="ChitChat" 
targetNamespace="http://www.chitchat.com/forum.wsd1" 
xmlns:tns="http://www.chitchat.com/forum.wsd1" 
xmlns:soap="http://schemas.xmlsoap.org/wsd1/soap/" 
xmlns:xsd="http: //www.w3.org/20@1/XMLSchema" 
xmlns="http://schemas.xmlsoap.org/wsdl/"> 
<message name="GetCommentRequest"> 

<part name="CommentId" type="xsd:string"/> 


</message> 
<message name="GetCommentResponse" > 
<part name="Text" type="xsd:string"/> 
</message> 
<portType name="GetCommentPortType" > 
<operation name="GetComment" > 
<input message="tns:GetCommentRequest"/> 
<output message="tns:GetCommentResponse"/> 
</operation> 
</portType> 
<binding name="GetCommentBinding" type="tns:GetCommentPortType"> 
<soap:binding style="rpc" 
transport="http://schemas.xmlsoap.org/soap/http"/> 
<operation name="GetComment" > 
<soap:operation soapAction="getComment"/> 


<input> 
<soap:body use="literal"/> 
</input> 
<output> 
<soap:body use="literal"/> 
</output> 
</operation> 
</binding> 
<service name="GetCommentService" > 
<documentation> 
Returns a comment 
</documentation> 


<port name="GetCommentPortType" binding="tns :GetCommentBinding" > 
<soap:address location="http://localhost :8080/GetComment"/> 
</port> 
</service> 
</definitions> 








位 于 报 文 开头 的 是 报 文 对 目 身 的 定义 ， 该 定义 给 出 了 报 文 各 个 部 分 
的 名 字 ， 以 及 这 些 部 分 的 类 型 : 





<message name="GetCommentRequest"> 

<part name="CommentId" type="xsd:string"/> 
</message> 
<message name="GetCommentResponse" > 

<part name="Text" type="xsd:string"/> 
</message> 


[L CR 


在 此 之 后 ， 报 文通 过 GetComment 操作 定义 了 
GetCommentPortType 端口 ， 该 操作 的 输入 报 文 
为 GetCommentRequest ， 而 输出 报 文 则 为 GetCommentResponse : 


<portType name="GetCommentPortType" > 
<operation name="GetComment" > 
<input message="tns:GetCommentRequest"/> 
<output message="tns:GetCommentResponse"/> 


</operation> 
</portType> 





最 后 ， 报 文 在 位 置 http://localhost:8080/GetComment 定 义 了 一 
个 GetCommentService 服务 ， 并 将 它 与 GetCommentPortType 端口 以 
及 GetCommentsBinding 地 址 进行 绑 定 : 


<service name="GetCommentService" > 
<documentation> 
Returns a comment 
</documentation> 
<port name="GetCommentPortType" binding="tns:GetCommentBinding" > 


<soap:address location="http://localhost:8080/GetComment"/> 
</port> 
</service> 
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生成 ， 同样 地 ，SOAP 啊 应 报 文 通常 也 是 由 WSDL 生 成 的 SOAP 服 务 器 负 
责 生成 。 具 体 语 言 的 客户 端 ( 如 一 个 Go SOAP 客 户 端 ) 通常 也 会 由 
WSDL 人 负责 生成 ， 而 其 他 代码 则 会 通过 使 用 这 个 客户 端 与 服务 器 进行 交 
互 。 这 样 做 的 结果 是 ， 只 要 WSDL 是 明确 定义 的 ， 那 么 它 生 成 的 SOAP 





客户 端 通常 也 会 是 健壮 的 ， 与 此 同时 ， 这 种 做 法 的 缺陷 是 ， 开 发 人 员 每 
次 修改 服务 器 ， 即 使 是 修改 返回 值 的 类 型 这 样 微小 的 修改 ， 客 户 端 都 需 
要 重新 生成 。 重 复生 成 客户 端的 过 程 通常 都 是 元 长 而 乏味 的 ， 这 也 解释 
了 为 什么 SOAP Web 服 务 通常 很 少 会 出 现 大 量 的 修改 一 一 因为 对 大 型 的 
SOAP Web 服 务 来 说 ， 频 繁 的 修改 将 是 一 场 距 梦 。 











本 章 接 下 来 不 会 再 对 基于 SOAP 的 Web 服 务 做 进一步 的 介绍 ， 但 我 
们 会 学 习 如 何 使 用 Go 语言 创建 以 及 分 析 XML。 


7.3 ”基于 REST 的 Web 服 务 简 介 


REST (Representational State Transfer， 上 有 具象 状态 传输 ) 是 一 种 设计 
理念 ， 用 于 设计 那些 通过 标准 的 几 个 动作 来 操纵 资源 ， 并 以 此 来 进行 相 
互 交 流 的 程序 (很 多 REST 使 用 者 都 会 把 操纵 资源 的 动作 称 为 “动词 ”， 
也 就 是 verb) 。 











在 大 多 数 编程 范 型 里 面 ， 程 序 员 都 是 通过 定义 函数 然后 在 主 程序 中 
有 序 地 调用 这 些 函数 来 完成 工作 的 。 在 面 癌 对 象 编程 (OOP〉 范 型 中 ， 
程序 员 要 做 的 事情 也 是 类 似 的 ， 主 要 的 区 别 在 于 ， 程 序 员 通过 创建 称 为 
WR Cobject) 的 模型 来 表示 事物 ， 然 后 定义 称 为 方法 (method) 的 函 
数 并 将 它们 附着 到 模型 之 上 。REST 是 以 上 思想 的 进化 版 ， 但 它 并 不 是 
把 函数 暴露 Cexpose) 为 可 调用 的 服务 ， 而 是 以 资源 (resource) 的 名 
义 把 模型 暴露 出 来 ， 并 人 允许 人 们 通过 少数 几 个 称 为 动词 的 动作 来 操纵 











在 使 用 HTTP 协 议 实现 REST 服 务 时 ，URL 将 用 于 表示 资源 ， 而 
HTTP 方 法 则 会 用 作 操 纵 资 源 的 动词 ， 具 体 如 表 7-1 所 示 。 





表 7-1 使 用 HTTP 方 法 与 Web 服 务 进行 通信 





在 一 项 资源 尚未 存在 的 情况 下 创建 该 资源 POST /users 





GET 获取 一 项 资源 GET /users/1 





重新 给 定 URL 上 的 资源 PUT /users/1 





刚 开 始 学 习 REST 的 程序 员 在 第 一 次 看 到 REST 使 用 的 HTTP 方法 与 








数据 库 的 CRUD 操 作 之 间 的 映射 关系 时 ， 常 常会 对 此 感到 非常 惊奇 。 需 
要 注意 的 是 ， 这 种 映射 并 不 是 一 对 一 映射 ， 而 且 这 种 映射 也 不 是 唯一 
的 。 比 如 说 ， 在 创建 一 项 新 的 资源 时 用 户 既 可 以 使 用 POST ， 也 可 以 使 
用 PUT ， 这 两 种 做 法 都 符合 REST 风 格 。 





POST 和 PUT 的 主要 区 别 在 于 ， 在 使 用 PUT 时 需要 准确 地 知道 哪 一 
项 资源 将 会 被 蔡 换 ， 而 使 用 POST 只 会 创建 出 一 项 新 资源 以 及 一 个 新 
URL。 换 句 话说，POST 用 于 创建 一 项 全 新 的 资源 ， 而 PUT UHF Ë 
一 项 已 经 存在 的 资源 。 





正如 第 1 章 所 言 ，PUT 方法 是 肾 等 的 ， 无 论 同一 个 调用 重复 执行 多 
少 次 ， 服 务 器 的 状态 都 不 会 发 生 任 何 变化 。 无 论 是 使 用 PUT 创建 一 项 资 
源 ， 还 是 使 用 PUT 修改 一 项 已 经 存在 的 资源 ， 给 定 的 URL 上面 都 只 会 有 
一 项 资源 被 创建 出 来 。 相 反 地 ， 因 为 POST 并 不 是 窜 等 的 ， 所 以 每 调 
用 POST 一 次 ， 它 就 会 创建 一 项 新 资源 以 及 一 个 新 URL。 








对 刚 开 始 学 习 REST 的 程序 员 来 说 ， 另 一 个 需要 注意 的 地 方 是 ， 
REST 并 不 是 只 能 通过 表 7-1 提 到 的 4 个 HTTP 方 法 实现 ， 比 如 ， 不 太 常 见 
的 PATCH 方法 就 可 以 用 于 对 一 项 资源 进行 部 分 更 新 。 


下 面 是 一 个 REST 请 求 示 例 : 


GET /comment/123 HTTP/1.1 


注意 ， 这 个 GET 请 求 并 没有 与 之 相关 联 的 主体 ， 而 与 这 个 GET 请 求 
相对 应 的 SOAP 请 求 则 正好 相反 
POST /GetComment HTTP/1.1 


Host: www.chitchat.com 
Content-Type: application/soap+xml; charset=utf-8 


<?xml version="1.0"?> 

<soap: Envelope 

xmlns:soap="http: //www.w3.org/2001/12/soap-envelope" 

soap: encodingStyle="http: //www.w3.org/2001/12/soap-encoding" > 


<soap:Body xmlns:m="http://www.chitchat.com/forum" > 
<m:GetCommentRequest> 
<m: CommentId>123</m:CommentId> 
</m:GetCommentRequest > 
</soap :Body> 
</soap:Envelope> 





这 是 因为 在 发 送 第 一 个 请 求 的 时 候 ， 我 们 使 用 了 HTTP 的 GET 方法 
作为 动词 来 获取 资源 《在 这 个 例子 中 ， 资 源 就 是 一 条 博客 评论 ) 。 对 于 
这 个 GET 请 求 ， 即 使 Web 服 务 返 回 一 个 SOAP 响 应 ， 它 也 会 被 认为 是 一 
个 REST 风 格 的 响应 : 这 是 因为 REST 跟 SOAP 不 同 ， 前 者 关注 的 是 API 的 
设计 ， 而 后 者 关注 的 则 是 被 发 送 报 文 的 格式 。 不 过 ， 因 为 SOAP 报 文 构 
建 起 来 非常 麻烦 ， 所 以 人 们 在 使 用 REST API 的 时 候 通常 都 是 返回 
JSON， 或 者 返回 一 些 比 SOAP 报 文 要 简单 得 多 的 XML， 而 很 少 会 返回 
SOAP 报 文 。 





正如 WSDL 跟 SOAP 的 关系 一 样 ， 基 于 REST 的 Web 服 务 也 拥有 相应 
的 WADL (Web Application Description Language，Web 应 用 摘 述 语 


言 )》 ， 这 种 语言 可 以 对 基于 REST 的 Web 服 务 进行 描述 ， 甚 至 能 够 生成 
访问 这 些 服务 的 客户 端 。 但 是 跟 WSDL 不 同 的 是 ，WADL 没 有 得 到 广泛 
的 使 用 ， 也 没有 进行 标准 化 。 此 外 ，WADL 也 拥有 Swagger、 

RAML (Restful API Modeling Language，REST 风 格 API 建 模 语 言 ) 和 

JSON-home 这 样 的 同类 苋 争 产 品 。 


在 刚 开 始 接 触 REST 的 时 候 ， 你 可 能 会 意识 到 这 种 设计 理念 非常 适 
用 于 那些 只 执行 简单 的 CRUD 操 作 的 应 用 ， 但 REST 是 否 适 用 于 更 为 复 
杂 的 服务 呢 ? 除 此 之 外 ， 它 又 是 如 何 对 过 程 或 者 动作 进行 建 模 的 呢 ? 











举 个 例子 ， 在 使 用 REST 设 计 的 情况 下 ， 一 个 应 用 要 如 何 才能 激活 
一 个 用 户 的 账号 呢 ? 因为 REST 只 人 允许 用 户 使 用 指定 的 几 个 HTTP 方法 操 
纵 资源 ， 而 不 允许 用 户 对 资源 执行 任意 的 动作 ， 所 以 应 用 是 无 法 发 送 像 
下 和 面 这 样 的 请 求 的 : 


ACTIVATE /user/456 HTTP/1.1 


有 一 些 办 法 可 以 绕 过 这 个 问题 ， 下 面 是 最 常用 的 两 种 方法 : 





(1) 把 过 程 具 体 化 站， 或 者 把 动作 转换 成 名 词 ， 然 后 将 其 用 作 资 
源 ; 


(2) 将 动作 用 作 资 源 的 属性 。 
7.3.1 将 动作 转换 为 资源 
对 于 上 面 列举 的 例子 ， 我 们 可 以 把 对 用 户 的 激活 动作 转换 为 对 资源 


的 激活 动作 ， 然 后 通过 向 资源 发 送 HTTP 方 法 来 执行 激活 动作 ， 这 样 一 
来 ， 我 们 就 可 以 通过 以 下 方法 激活 指定 的 用 户 : 


POST /user/456/activation HTTP/1.1 


{ "date": "2015-@5-15T13:05:@5Z" } 





这 段 代码 将 创建 一 个 被 激活 的 资源 〈activation resource) ， 以 此 来 
表示 用 户 的 激活 状态 。 这 种 做 法 的 另 一 个 好 处 是 ， 它 可 以 为 被 激活 的 资 
源 添加 额外 的 属性 。 比 如 ， 在 上 面 展 示 的 例子 中 ， 我 们 惑 将 一 个 日 期 附 
加 给 了 被 激活 的 资源 。 


7.3.2 ”将 动作 转换 为 资源 的 属性 


如 果 用 户 的 激活 与 否 可 以 通过 用 户 账 号 的 一 个 状态 来 确定 ， 那 么 我 
们 只 需要 将 激活 动作 用 作 资 源 的 属性 ， 然 后 通过 HTTP 的 PATCH 方法 对 
该 资源 进行 部 分 更 新 即 可 ， 就 像 这 样 : 


PATCH /user/456 HTTP/1.1 


{ "active" : "true" } 





这 段 代 码 将 把 用 户 资 源 的 active 属性 设置 为 true 。 


7.4 ”通过 Go 分 析 和 创建 XML 


在 对 SOAP 风 格 的 Web 服 务 和 REST 风 格 的 Web 服 务 有 了 基本 的 了 解 
之 后 ， 接 下 来 就 让 我 们 看 看 Go 语言 是 如 何 实现 这 两 种 服务 的 。 首 先 ， 
本 节 会 介绍 如 何 创建 和 处 理 SOAP Web 服 务 会 用 到 的 XML 数据 ， 而 下 一 
节 则 会 介绍 如 何 创建 和 处 理 REST Web 服 务 会 用 到 的 JSON 数 据 。 





XML 可 以 以 结构 化 的 形式 表示 数据 ， 它 跟 本 书 前 面 提 到 的 HTML 一 
样 ， 都 是 一 种 流行 的 标记 语言 。XML 可 能 是 在 表示 、 发 送 和 接收 结构 
化 数据 方面 使 用 最 广泛 的 一 种 格式 ， 这 种 格式 获得 了 W3C 组 织 的 正式 推 
荐 ，W3C 友 布 的 XML 1.0 规 范 中 给 出 了 这 一 格式 的 具体 定义 。 


因为 我 们 经 常会 用 到 其 他 人 提供 的 web 服务 ， 或 者 需要 处 理 诸如 
RSS 这 样 基 于 XML 的 数据 源 ， 所 以 无 论 你 最 终 是 否 会 编号 或 使 用 Web 服 
务 ， 学 习 如 何 创建 和 分 析 XML 都 是 一 项 非常 重要 的 技能 。 即 使 你 不 需 
要 开发 自己 的 XML Web 服 务 ， 学 会 如 何 使 用 Go 与 XML 进行 交互 也 是 非 
常 有 用 的 一 件 事 。 比 如 说 ， 你 可 能 会 需要 从 一 个 RSS 新 闻 源 里 面 获取 数 
据 ， 并 将 其 用 作 自 己 的 数据 源 之 一 。 在 这 种 情况 下 ， 你 必须 懂得 如 何 分 
析 XML 并 从 中 提取 出 自己 想 要 获取 的 信息 。 





无 论 是 使 用 XML、JSON 还 是 其 他 格式 ， 使 用 Go 语言 分 析 结 构 化 数 
据 的 方法 都 是 相似 的 。 对 XML 和 JSON 进 行 操作 需要 分 别 用 到 encoding 
库 中 的 XML 子 包 和 JSON 子 包 ， 现 在 ， 就 让 我 们 来 看 看 encoding/xm1l 
子 包 的 使 用 方法 。 


7.4.1 分 析 XML 


因为 分 析 XML 是 刚 开 始 接触 XML 时 经 常会 做 的 一 件 事 ， 所 以 我 们 
就 以 学 习 如 何 分 析 XML 为 开始 。 在 Go 语言 里 面 ， 用 户 首先 需要 将 XML 
的 分 析 结 果 存 储 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 结构 来 获取 XML 
记录 的 数据 。 下 面 是 分 析 XML 时 第 见 的 两 个 步骤: 


C1) 创建 一 些 用 于 存储 XML 数据 的 结构 ; 


(2) 使 用 xml.Unmarshal 将 XML 数据 解 封 Cunmarshal) 到 结构 
里 面 ， 如 图 7-2 所 示 。 





图 7-2 ”使 用 Go 对 XML 进 行 分 析 : 将 XML 解 封 至 结构 
代码 清单 7-1 展 示 了 一 个 简单 的 XML 文 件 post.xml 。 
代码 清单 7-1 ”一 个 简单 的 XML 文件 post .xml 


<?xml version="1.0" encoding="utf-8"?> 
<post id="1"> 
<content>Hello World!</content> 


<author id="2">Sau Sheong</author> 
</post> 





代码 清单 7-2 展 示 了 分 析 这 个 XML 所 需 的 代码 ， 这 些 代 码 存 储 在 文 
件 xml.go 里 。 


代码 清单 7-2 ”对 XML 进行 分 析 





package main 


import ( 
"encoding/xm1" 
"fmt" 
"io/ioutil" 
"os" 
) 
type Post struct { //#A e 
XMLName xml.Name ~xml:"post"~ 
Id string ~xml:"id,attr"” 
Content string ~xml:"content"” 
Author Author ~~ xml:"author"~ 
Xml string ` xml:",innerxml"` 
} 


type Author struct { 
Id string `xml:"id,attr"` 
Name string `xml:",chardata"` 


} 
func main() { 
xmlFile, err := os.Open("post.xml") 
if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 
} 


defer xmlFile.Close() 
xmlData, err := ioutil.ReadAll(xmlFile) 


if err != nil { 
fmt.Println("Error reading XML data:", err) 
return 

} 


var post Post 
xml.Unmarshal(xmlData, &post) o@ 
fmt.Println(post) 


} 





@ 定义 一 些 结构 ， 用 于 表示 数据 


O 将 XML 数据 解 封 到 结构 里 面 


分 析 程 序 定义 了 用 于 表示 数据 的 Post 结构 和 Author 结构 。 因 为 程 
序 想 要 在 获取 作者 信息 的 同时 也 获取 作者 信息 所 在 元 素 的 id 属性 ， 所 
以 程序 使 用 了 单独 的 Author 结构 来 表示 帖子 的 作者 ， 但 并 没有 使 用 单 
独 的 Content 结构 来 表示 帖子 的 内 容 。 如 果 我 们 不 打算 获取 作者 信息 的 
id 属性 ， 也 可 以 定义 一 个 下 面 这 样 的 Post 结构 ， 并 直接 使 用 字符 串 来 
表示 帖子 的 作者 信息 (代码 中 的 加 粗 行 〉: 














type Post struct { 
XMLName xml.Name xml:"post". 
Id string ~ xml:"id,attr". 


Content string —~xml:"content"” 
Author string “Xml1:"author 


Xml string ~xml: ",innerxml"~ 





Post 结构 中 每 个 字段 的 定义 后 面 都 融 有 一 段 使 用 反 引 号 (*) 包围 
的 信息 ， 这 些 信息 被 称 为 结构 标签 (struct tag) ，Go 语 言 使 用 这 些 标签 
来 决定 如 何 对 结构 以 及 XML 元 素 进行 映射 ， 如 图 7-3 所 示 。 











结构 标签 


type Post struct { 
XMLName xml.Name ‘xml: "post" 


Id string ‘xml:"id,attr" 
Content string “xml: "content" 
Author Author ‘xml: "author" ` 


Xml string xml: ”,innerxml" ` 

} y Ba 
键 值 
图 7-3 ”结构 标签 用 于 定义 XML 和 结构 之 间 的 映射 


结构 标签 是 一 些 跟 在 字段 后 面 ， 使 用 字符 串 表 示 的 键 值 对 : 它 的 键 
是 一 个 不 能 包含 空格 、 引 号 〈") RARS C) 的 字符 串 ， 而 值 则 是 
一 个 被 双 引 号 〈"" ) 包围 的 字符 串 。 在 处 理 XML 时 ， 结 构 标 签 的 键 总 


是 为 xml 。 


为 什么 使 用 反 引 号 来 包围 结构 标签 

















因为 Go 语言 使 用 双 引 号 C") 和 反 引 号 C) 来 包围 字符 串 ， 使 用 单 引 号 (' ) 来 包围 
rune (一 种 用 于 表示 Unicode 人 码 点 的 ijnt32 类 型 ) ， 并 且 因为 结构 标签 内 部 已 经 使 用 了 双 引 号 
来 包围 键 的 值 ， 所 以 为 了 避免 进行 转 义 ，Go 语 言 就 使 用 了 反 引 号 来 包围 结构 标签 。 














出 于 创建 映射 的 需要 ，xml 包 要 求 被 映射 的 结构 以 及 结构 包含 的 所 
有 字段 都 必须 是 公开 的 ， 也 惑 是 ， 它 们 的 名 字 必 须 以 大 写 的 英文 字母 开 
头 。 以 上 面 展示 的 代码 为 例 ， 结 构 的 名 字 必 须 为 Post 而 不 能 是 post ， 


至 于 字段 的 名 字 则 必须 为 Content 而 不 能 是 content 。 
下 面 是 XML 结构 标签 的 其 中 一 些 使 用 规则 。 


(1) 通过 创建 一 个 名 字 为 XMLName 、 类 型 为 xm1.Name 的 字段 ， 
可 以 将 XML 元 素 的 名 字 存 储 在 这 个 字段 里 面 〈 在 一 般 情况 下 ， 结 构 的 
名 字 就 是 元 素 的 名 字 ) o 














(2) 通过 创建 一 个 与 XML 元 素 属 性 同名 的 字段 ， 并 使 用 'xm1:" 
<name >,attr" ' 作 为 该 字段 的 结构 标签 ， 可 以 将 元 素 的 cname > 属性 
的 值 存储 到 这 个 字段 里 面 。 





(3) 通过 创建 一 个 与 XML 元 素 标签 同名 的 字段 ， 并 使 
用 'xml:",chardata"' 作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 素 的 字 
符 数 据 存储 到 这 个 字段 里 面 。 





(4) 通过 定义 一 个 任意 名 字 的 字段 ， 并 使 用 'xml:",innerxml"' 
作为 该 字段 的 结构 标签 ， 可 以 将 XML 元 素 中 的 原始 XML 存储 到 这 个 字 
段 里 面 。 


(5) 没有 模式 标志 (如 ,attr 、,chardata 或 者 ,innerxml ) 的 
结构 字段 将 与 同名 的 XML 元 素 匹 配 。 





(6) 使 用 'xml:"a>b>c"" 这 样 的 结构 标签 可 以 在 不 指定 树 状 结构 
的 情况 下 直接 获取 指定 的 XML 元 素 ， 其 中 a 和 b 为 中 间 元 紊 ， 而 c 则 是 
想 要 获取 的 节点 元 素 。 




















要 一 下 子 了 解 这 么 多 规则 并 不 容易 ， 特 别 是 对 最 后 儿 条 规则 来 说 更 





是 如 此 ， 所 以 我 们 最 好 还 是 来 看 一 些 实际 应 用 这 些 规则 的 例子 。 


代码 清单 7-3 给 出 了 表示 帖子 XML 元 素 的 post 变量 及 其 对 应 的 Post 
结构 。 























代码 清单 7-3 ”用 于 表示 帖子 的 简单 的 XML 元 素 

















<post id="1"> 
<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 


</post> 





而 下 面 是 post 元 素 对 应 的 Post 结构 : 


type Post struct { 
XMLName xml.Name ~xml:"post"~ 
Id string ~xml:"id,attr"” 
Content string ~xml:"content"” 


Author Author ~~ xml:"author"~ 
Xml string `xml:",innerxml]1"` 


} 





分 析 程 序 定义 了 与 XML 元 素 post 同名 的 Post 结构 ， 虽 然 这 种 做 法 
非常 常见 ， 但 是 在 某 些 时 候 ， 结 构 的 名 字 与 XML 元 素 的 名 字 可 能 并 不 
相同 ， 这 时 用 户 就 需要 一 种 方法 来 获取 元 素 的 名 字 。 为 此 ，xml 包 提 供 
了 一 种 机 制 ， 使 用 户 可 以 通过 定义 一 个 名 为 XMLName 、 类 型 
为 xm1.Name 的 字段 ， 并 将 该 字段 映射 至 元 素 自 映 来 获取 XML 元 素 的 名 
字 。 在 Post 结构 的 例子 中 ， 这 一 映射 承 是 通过 ' xm1:"post"' 结构 标 
签 来 完成 的 。 根 据 规则 1 一 一 “使 用 XMLName 字段 存储 元 素 的 名 字 ”， 分 
析 程 序 将 元 素 的 名 字 post 存储 到 了 Post 结构 的 XMLName 字段 里 面 。 























XML 元 素 post 拥有 一 个 名 为 id 的 属性 ， 根 据 规则 2 一 一 “使 用 结构 
标签 xml:"&lt;name&gt;,`` attr" </code> 存 储 属 性 的 值 ”， 
分 析 程 序 通 过 结构 标签 ccode> xml:"id,attr"` 将 id 属性 的 值 存 储 到 
J Post 结构 的 Id FREH. 





post 元 素 包 含 了 一 个 content 子 元 素 ， 这 个 子 元 素 没 有 属性 ， 但 
它 包含 了 字符 数据 Hello World! ， 根 据 规则 5 一 一 “没有 模式 标志 的 结 
构 字段 将 与 同名 的 XML 元 素 进 行 上 匹配?”， 分 析 程 序 通过 结构 标 
签 'xml:"content"' 将 content PREAH LA Bo A Bl J Post 
结构 的 Content 字段 里 面 。 





根据 规则 4 一 一 “使 用 结构 标签 'xml:",innerxml"' 可 以 获取 原始 
XML”， 分 析 程 序 定义 了 一 个 Xml1 字段 ， 并 使 用 'xml:",innerxml"' 作 
为 该 字段 的 结构 标签 ， 以 此 来 获得 被 post 元 素 包 含 的 原始 XML: 








<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 





子 元 素 author 拥有 id 属性 ， 并 且 包 含 字 符 数 据 Ssau Sheong, X 
了 正确 地 构建 映射 ， 分 析 程序 专门 定义 了 Author 结构 : 
type Author struct { 


Id string ~xml:"id,attr"- 
Name string ~xml:",chardata"” 


} 





根据 规则 5，author 子 元 素 被 映射 到 了 带 有 "xm1:"author"' 结构 


标签 的 Author 字段 。 在 Author 结构 中 ， 属 性 id 的 值 被 映射 到 了 带 
有 'xml:"id,attr"' 结构 标签 的 Id 字段 ， 而 字符 数据 Sau Sheong 则 
被 映射 到 了 带 有 'xml:",chardata"' 结构 标签 的 Name 字段 。 


俗话 说 ， 百 闻 不 如 一 见 。 在 详细 了 解 了 整个 分 析 程 序 之 后 ， 接 下 来 
就 让 我 们 实际 运行 一 下 这 个 程序 。 在 终端 里 面 执行 以 下 命令 : 


如 果 一 切 正 常 ， 这 一 命令 应 该 会 返回 以 下 结果 : 


{{ post} 1 Hello World! {2 Sau Sheong} 
<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 


} 





让 我 们 逐一 地 分 析 这 些 结果 。 首 先 ， 因 为 post 变量 是 Author 结构 
的 一 个 实例 ， 所 以 整个 结果 都 被 包围 在 了 一 对 大 括号 〈{} ) 里 
面 。post 结构 的 第 一 个 字段 是 另 一 个 类 型 为 xml.Name 的 结构 ， 这 个 结 
构 在 结果 中 表示 为 { post } 。 在 此 之 后 展示 的 数字 1 为 Id 字段 的 值 ， 
而 "Hello World!" 则 是 Content 字段 的 值 。 再 之 后 展示 的 是 存储 
在 Author 结构 里 面 的 内 容 ，{2 Sau Sheong} 。 结 果 最 后 展示 的 是 
XML 元 素 post 内 部 包含 的 原始 XML 。 




















前 面 的 内 容 列 举 了 规则 1 至 规则 5 的 使 用 示例 ， 现 在 让 我 们 来 看 看 规 
则 6 是 如 何 运 作 的 。 规 则 6 声称 ， 使 用 结构 标签 "xml:"a>b>c"'， 可 以 
在 不 指定 树 状 结构 的 情况 下 ， 越 过 中 间 元 素 a Mb 直接 访问 节点 元 素 c 





代码 清单 7-4 展 示 的 是 另 一 个 XML 示例 ， 这 个 XML 也 存储 在 名 
为 post .xml 的 文件 中 。 





代码 清单 7-4 ARC RR XML XE 





< ?Xml version="1.0" encoding="utf-8"?> 
< post id="1"> 
< content>Hello World!< /content> 
< author id="2">Sau Sheong< /author> 
< comments> 


< comment id="1"> 


< content>Have a great day!< /content> 


< author id="3">Adam< /author> 


< /comment> 


< comment id="2"> 


< content>How are you today?< /content> 


< author id="4">Betty< /author> 


< /comment> 


< /comments> 


< /post> 





这 个 XML 文件 的 前 半 部 分 内 容 跟 之 前 展示 的 XML 文件 是 相同 的 ， 
而 加 粗 显示 的 则 是 新 出 现 的 代码 ， 这 些 新 代码 定义 了 一 个 名 
为 comments 的 XML 子 元 素 ， 并 且 这 个 元 素 本 身 也 包含 多 个 comment T 
元 素 。 这 一 次 ， 分 析 程 序 需要 获取 帖子 的 评论 列表 ， 但 为 此 专门 创建 一 
个 Comments 结构 可 能 会 显得 有 些小 题 大 做 了 。 为 了 人 简化 实现 代码 ， 分 
析 程 序 将 根据 规则 6 对 comments 这 个 XML 子 元 素 进行 跳跃 式 访问 。 代 
码 清单 7-5 展 示 了 经 过 修改 的 Post 结构 ， 修 改 后 的 Post 结构 带 有 新 增 
的 字段 以 及 实现 跳跃 式 访问 所 需 的 结构 标签 。 





代码 清单 7-5 带 有 comments 结构 字段 的 Post 结构 


type Post struct { 
XMLName xml.Name ~ xml:"post"” 
Id string ~xml:"id,attr"” 
Content string ~xml: "content" 
Author Author ~xml:"author"~ 
Xml string `xml:",innerxml"` 
Comments []Comment `xml:"comments>comment"` 





正如 代码 中 的 加 粗 行 所 示 ， 分 析 程 序 为 了 获取 帖子 的 评论 列表 ， 
在 Post 结构 中 增加 了 类 型 为 Comment 结构 切片 的 Comments 字段 ， 并 通 
过 结构 标签 'xml:"comments>comment"' 将 这 个 字段 映射 至 名 
为 comment 的 XML 子 元 素 。 根 据 规则 6， 这 一 结构 标签 将 允许 分 析 程 序 
跳 过 XML 中 的 comments 元 素 ， 直 接 访 问 comment 子 元 素 。 








Comment 结构 和 Post 结构 非常 相似 ， 它 的 具体 定义 如 下 : 


type Comment struct { 
Id string ~xml:"id,attr"- 
Content string ~xml:"content"” 


Author Author ~xml:"author"~ 


} 





在 定义 了 进行 语法 分 析 所 需 的 结构 以 及 映射 关系 之 后 ， 现 在 是 时 候 
将 XML 数据 解 封 到 这 些 结构 里 面 了 。 因 为 负责 执行 解 封 操作 的 
Unmarshal 函数 只 接受 字 节 切片 (也 就 是 字符 串 〉 作 为 参数 ， 所 以 分 析 
程序 首先 要 做 的 就 是 将 XML 文 件 转 换 为 字符 串 ， 这 一 操作 可 以 通过 以 
下 代码 来 实现 (在 执行 这 些 代码 时 ，XML 文 件 必 须 与 Go 文件 处 于 同一 
目录 之 下 ) : 





xmlFile, err := os.Open("post.xml") 

if err != nil { 
fmt.Printin("Error opening XML file:", err) 
return 


defer xmlFile.Close() 

xmlData, err := ioutil.ReadAll(xmlFile) 

if err != nil { 
fmt.Printin("Error reading XML data:", err) 
return 


} 


[L CR 


在 将 XML 文件 的 内 容 读 取 到 xm1lData 变量 里 面 之 后 ， 分 析 程 序 可 
以 通过 执行 以 下 代码 来 解 封 XML 数 据 : 


Var post Post 
xml.Unmarshal(xmlData, &post) 





如 条 你 曾经 使 用 其 他 编程 语言 分 析 过 XML， 那 么 你 应 该 会 知道 ， 





这 种 做 法 虽然 能 够 很 好 地 处 理 体 积 较 小 的 XML 文件 ， 但 是 却 无 法 高 效 
地 处 理 以 流 (stream) 方式 传输 的 XML 文件 以 及 体积 较 大 的 XML 文件 。 
为 了 解决 这 个 问题 ， 我 们 需要 使 用 Decoder 结构 来 代替 Unmarshal K 
数 ， 通 过 手动 解码 XML 元 又 的 方式 来 解 封 XML 数据 ， 这 个 过 程 如 图 7-4 
所 示 。 





图 7-4 使 用 Go 分 析 XML: 将 XML 解码 至 结构 


代码 清单 7-6 展 示 了 如 何 使 用 Decoder 分 析 前 面 提 到 的 XML 文件 。 


代码 清单 7-6 ”使 用 Decoder 分 析 XML 





package main 


import ( 
"encoding/xml" 
"fmt" 
n io" 
"os LLI 


) 
type Post struct { 
XMLName xml.Name ~xml:"post 


Id string `xml:"id,attr"` 
Content string `xml: "content" 
Author Author `xml:"author"` 
Xml string `xml:",innerxml"` 


Comments []Comment ‘xml:"comments>comment 


} 


type Author struct { 
Id string `xml:"id,attr" 
Name string `xml:",chardata 


} 


type Comment struct { 
Id string `xml:"id,attr"` 
Content string `xml:"content"` 
Author Author ~ xml: "author" 


} 


func main() { 
xmlFile, err := os.Open("post.xml") 
if err != nil { 
fmt.Println("Error opening XML file:", err) 
return 


} 
defer xmlFile.Close() 


decoder := xml.NewDecoder(xmlFile) @ 
for { @ 
t, err := decoder.Token() © 
if err == io.EOF { 
break 
} 
if err != nil { 
fmt.Println("Error decoding XML into tokens:", err) 
return 


} 


switch se := t.(type) { @ 
case xml.StartElement: 
if se.Name.Local == "comment" { 
var comment Comment 
decoder .DecodeElement(&comment, &se) © 
} 
} 
} 


@ 根据 给 定 的 XML 数据 生成 相应 的 解码 器 

O 每 迭代 一 次 解码 器 中 的 所 有 XML 数据 

O 每 进行 一 次 近代， 就 从 解码 器 里 面 获取 一 个 token 
@ 检查 token 的 类 型 

O 将 XML 数据 解码 至 结构 


虽然 这 段 代 码 只 演示 了 如 何 解 码 comment 元 素 ， 但 这 种 解码 方式 同 
样 可 以 应 用 于 XML 文件 中 的 其 他 元 素 。 这 个 新 的 分 析 程序 会 通过 
Decoder 结构 ， 一 个 元 素 接 一 个 元 素 地 对 XML 进 行 解 码 ， 而 不 是 像 之 
前 那样 ， 使 用 Unmarshal 函数 一 次 将 整个 XML 解 封 为 字符 串 。 





对 XML 进行 解码 首先 需要 创建 一 个 Decoder ， 这 一 点 可 以 通过 调 
用 NewDecoder 并 向 其 传递 一 个 io .Reader 来 完成 。 在 上 面 展示 的 代码 
清单 中 ， 程 序 就 把 os.0pen 打开 的 xmlFile 文件 传递 给 了 NewDecoder 


在 拥有 了 解码 器 之 后 ， 程 序 就 会 使 用 Token 方法 来 获取 XML 流 中 
的 下 一 个 token: 在 这 种 情景 下 ，token 实 际 上 就 是 一 个 表示 XML 元 素 的 
接口 。 为 了 从 解码 器 里 面 取 出 所 有 token， 程 序 使 用 一 个 无 限 for 循环 包 
里 起 了 从 解码 器 里 面 获取 token 的 相关 动作 。 当 解码 器 包含 的 所 有 token 
都 已 被 取出 时 ，Token 方法 将 返回 一 个 表示 文件 数据 或 数据 流 已 被 读 取 





完毕 的 io.EOF 结构 作为 结果 ， 并 将 返回 值 中 的 err 变量 的 值 设置 为 nil 


分 析 程 序 从 解码 器 里 取出 token 之 后 会 对 该 token 进 行 检 查 以 确认 其 
是 否 为 StartElement ， 也 就 是 ， 判 断 该 token 是 否 为 XML 元 素 的 起 始 
标签 。 如 果 是 的 话 ， 那 么 程序 会 继续 对 这 个 token 进 行 检 查 ， 看 它 是 否 
就 是 XML 中 的 comment WR. FEMA SA CISA comment AZ 
后 ， 程 序 就 会 将 整个 token 解 码 至 Comment 结构 ， 从 而 得 到 与 解 封 XML 
元 素 相 同 的 结 末 。 


因为 手动 解码 XML 文件 需要 做 更 多 工作 ， 所 以 这 种 方法 并 不 适用 
于 处 理 小 型 的 XML 文件 。 但 如 果 程 序 面 对 的 是 流 式 XML 数据 ， 或 者 体 
积 非常 庞大 的 XML 文件 ， 那 么 解码 将 是 从 XML 里 提取 数据 唯一 可 行 的 
办 法 。 








在 结束 本 小 市 并 转向 讨论 如 何 创建 XML 之 前 ， 还 有 一 点 需要 说 明 
一 下 ， 那 就 是 :本 市 介绍 的 分 析 规 则 只 是 XML 分 析 规 则 的 一 部 分 ， 如 
果 你 想 要 更 详细 地 了 解 这 些 规则 ， 可 以 去 查看 xml 库 的 文档 ， 或 者 直接 
阅读 xml 库 的 源码 。 


7.4.2 ”创建 XML 


在 上 一 节 中 ， 我 们 花 了 不 少时 间 学 习 如 何 分 析 XML， 科 运 的 是 ， 
因为 创建 XML 正好 束 是 分 析 XML 的 逆 操作 ， 所 以 上 一 节 介 绍 的 知识 在 
本 市 也 是 适用 的 。 在 上 一 节 中 ， 我 们 学 习 的 是 怎样 把 XML 解 封 到 结构 
里 面 ， 而 这 一 节 我 们 要 学 习 的 则 是 怎样 把 Go 结构 封装 (marshal) 至 
XML; 同样 ， 上 一 节 我 们 学 习 的 是 怎样 把 XML 解码 至 Go 结构 ， 而 本 节 





我 们 要 学 习 的 则 是 怎样 把 Go 结构 编码 至 XML， 这 个 过 程 如 图 7-5 所 示 。 





图 7-5 ”使 用 Go 创建 XML: 创建 结构 并 将 其 封装 至 XML 


首先 让 我 们 来 看 看 封装 操作 是 如 何 进行 的 。 代 码 清单 7-7 展 示 了 文 
件 xml.go 包含 的 代码 ， 这 些 代 码 会 创建 一 个 名 为 post .xml 的 XML 文 
件 。 


代码 清单 7-7 使 用 Marshal 函数 生成 XML 文件 





package main 


import ( 
"encoding/xml" 
"n" fmt LLI 
"io/ioutil" 


) 


type Post struct { 
XMLName xml.Name `xml:"post"` 
Id string ` xml:"id,attr"` 
Content string `xml:"content"` 
Author Author `xml:"author"` 


} 


type Author struct { 
Id string `xml:"id,attr"` 
Name string `xml:",chardata"` 


} 


func main() { 


Content: " Hello World!", @ 
Author: Author{ 


Id: “23 
Name: "Sau Sheong", 
Js 
} 


output, err := xml.Marshal(&post) 
if err != nil { @ 
fmt.Println("Error marshalling to XML:", err) 
return 
} 
err = ioutil.WriteFile("post.xml", output, 0644) 
if err != nil { 
fmt.Println("Error writing XML to file:", err) 
return 


} 





@@ 创 建 结构 并 向 里 面 填充 数据 





O 把 结构 封 朔 为 由 字 节 切片 组 成 的 XML 数据 


正如 代码 所 示 ， 封 装 XML 和 解 封 XML 时 使 用 的 结构 以 及 结构 标签 
是 完全 相同 的 : 封装 操作 只 不 过 是 把 处 理 过 程 反 转 了 过 来 ， 然 后 根据 结 
构 创 建 相 应 的 XML 罢了 。 封 装 程 序 首先 需要 创建 表示 帖子 的 post 结 
构 ， 并 向 结构 里 面 填 充 数据 ， 然 后 只 要 调用 Marshal 函数 ， 就 可 以 根 
据 Post 结构 创建 相应 的 XML 了 。 作 为 例子 ， 下 面 就 是 Marshal 函数 根 
据 Post 结构 创建 出 的 XML 数据 ， 这 些 数据 包含 在 了 post .xml 文件 里 
面 : 








<post id="1"><content>Hello World!</content><author id="2">Sau Sheong</aut 
hor></post> 





IR PEP FDE gE. E RAE RHE OR AY BY EY BAB i EB 
XML。 如 果 想 要 让 程序 生成 更 好 看 的 XML， 那 么 可 以 使 
用 MarshalIndent 函数 代替 Marshal 函数 : 





output, err := xml.MarshalIndent(&post, "", "\t") 





MarshalIndent 函数 跟 Marshal 函数 一 样 ， 都 接受 一 个 指向 结构 
的 指针 作为 自己 的 第 一 个 参数 ， 但 除 此 之 外 ，MarshalIndent 函数 还 
接受 两 个 额外 的 参数 ， 这 两 个 参数 分 别 用 于 指定 添加 到 每 个 输出 行 前 面 
的 前 缀 以 及 缩 进 ， 其 中 缩 进 的 数量 会 随 着 元 素 的 能 套 层次 增加 而 增加 。 
在 处 理 相 同 的 Post 结构 时 ，MarshalIndent 函数 将 产生 以 下 更 为 美观 
的 输出 : 





<post id="1"> 
<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 


</post> 





因为 这 段 XML 缺少 了 XML 声明 ， 上 所 以 从 格式 上 来 说 这 段 XML 并 不 
完全 正确 。 虽 然 xml 库 不 会 自动 为 Marshal aa nn 生成 
的 XML 添加 XML 声明 ， 但 用 户 可 以 很 轻易 地 通过 xm1.Header 常量 将 
XML 声明 添加 到 封装 输出 之 前 : 





err = ioutil.WriteFile("post.xml", []byte(xml.Header + string(output)), 86 
44) 





通过 把 xm1.Header 添加 到 输出 结果 之 前 ， 并 将 这 些 内 容 全 部 写 
入 post.xml 文件 ， 我 们 束 得 到 了 一 段 带 有 XML 声 明 的 XML: 


<?xml version="1.0" encoding="UTF-8"?> 
<post id="1"> 


<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 
</post> 





正如 我 们 可 以 手动 将 XML 解码 到 Go 结构 里 面 一 样 ， 我 们 同样 可 以 
手动 将 Go 结构 编码 到 XML 里面， 图 7-6 展 示 了 这 个 过 程 ， 代 码 清单 7-8 则 
展示 了 一 个 简单 的 编码 示例 。 








创建 结构 并 创建 用 于 存储 XML 创建 用 于 编码 通过 编码 器 把 结 
向 其 填充 数据 数据 的 XML 文件 结构 的 编码 器 构 编码 至 XML 文件 








图 7-6 ”使 用 Go 创建 XML: 通过 使 用 编码 需 来 将 结构 编码 至 XML 





代码 清单 7-8 手动 将 Go 结构 编码 至 XML 








package main 


import ( 
"encoding/xm1" 
"fmt" 
"os" 


) 


type Post struct { 
XMLName xml.Name `xml:"post™"` 


Id string ` xml:"id,attr" 

Content string ` xml:"content™"` 

Author Author `xml:"author"` 
} 


type Author struct { 
Id string `xml:"id,attr" 


Name string ~xml:",chardata"” 


} 


func main() { 
post := Post{ 
Id: "1", @ 
Content: "Hello World!", 
Author: Author{ 


Id: "Ara 
Name: "Sau Sheong", 
hs 
} 
xmlFile, err := os.Create("post.xml") @ 
if err != nil { 
fmt.Printin("Error creating XML file:", err) 
return 
} 
encoder := xml.NewEncoder(xmlFile) © 


encoder.Indent("", "\t") 
err = encoder.Encode(&post) @ 


if err != nil { 
fmt.Printin("Error encoding XML to file:", err) 
return 
} 
} 





@ 创建 结构 并 向 里 面 填充 数据 


O 创建 用 于 存储 数据 的 XML 文件 
O 根据 给 定 的 XML 文件 ， 创 建 出 相应 的 编码 器 
O 把 结构 编码 至 文件 


跟 之 前 一 样 ， 程 序 首先 创建 了 将 要 被 编码 的 Post 结构 ， 接 着 通过 
os.Create 创建 出 了 将 要 写 入 的 XML 文件 ， 然 后 使 用 NewEncoder 函数 
创建 了 一 个 包 里 着 XML 文 件 的 编码 器 。 在 设置 好 相应 的 前 级 和 缩 进 之 


后 ， 程 序 就 会 使 用 编码 器 的 Encode 方法 对 传 入 的 Post 结构 进行 编码 ， 
最 终 创 建 出 包含 以 下 内 容 的 post .xml 文件 : 


<post id="1"> 
<content>Hello World!</content> 
<author id="2">Sau Sheong</author> 


</post> 








通过 这 一 节 的 学 习 ， 读 者 应 该 已 经 了 解 了 如 何 分 析 和 创建 XML 。 
需要 注意 的 是 ， 本 节 讨 论 的 只 是 分 析 和 创建 XML 的 基础 知识 ， 如 下 想 
要 知道 天 于 这 方面 的 更 多 信息 ， 可 查看 相应 的 文档 以 及 源码 ( 别 担 心 ， 
阅读 源码 并 没有 想象 中 那么 可 怕 〉。 











7.5 通过 Go 分 析 和 创建 JSON 


JSON (JavaScript Object Notation) 是 衍生 上 自 JavaScript 语 言 的 一 种 
轻 量 级 的 文本 数据 格式 ， 这 种 格式 的 主要 设计 理念 是 既 能 够 轻易 地 被 人 
类 读 懂 ， 叉 能 够 简单 地 被 机 器 读 取 。JSON 最 初 由 Douglas Crockford 定 
义 ， 现 在 则 由 RFC 7159 和 ECMA-404 描 述 。 虽 然 接受 和 返回 JSON 数 据 
并 不 是 实现 REST Web 服 务 的 唯一 选择 ， 但 大 多 数 REST Web 服 务 都 是 这 
样 做 的 。 





在 与 REST Web 服 务 打交道 的 时 候 ， 我 们 常常 会 以 某 种 形式 与 JSON 
不 期 而 遇 ， 要 么 就 是 为 了 创建 JSON， 要 么 就 是 为 了 处 理 JSON， 又 或 者 
两 者 此 有 。 处 理 JSON 在 web 应 用 中 非常 常见 : 无 论 是 从 Web 服 务 里 面 获 
取 数 据 ， 还 是 通过 第 三 方 身 份 验证 服务 登录 Web 应 用 ， 又 或 者 对 其 他 服 
务 进 行 控 制 ， 通 常 都 需要 处 理 JSON 数 据 。 





跟 处 理 JSON 一 样 ， 创 建 JSON 也 非常 常见 : Go 语言 经 常会 被 用 于 创 
建 为 前 疹 应 用 提供 服务 的 Web 服 务 后 端 ， 其 中 就 包括 基于 JavaScript 的 前 
端 应 用 ， 而 这 些 应 用 篆 篆 会 运行 着 React.js 和 Angular.js 这 样 的 JavaScript 
库 。 除 此 之 外 ，Go 语 言 还 会 被 用 于 为 物 联 网 以 及 诸如 智能 手表 这 样 的 
可 罕 戴 设备 创建 Web 服 务 。 因 为 在 很 多 情况 下 ， 这 些 前 端 应 用 都 是 基于 
JSON 开 发 的 ， 所 以 它们 与 后 端 进行 交互 最 自然 的 方式 当然 也 是 使 用 
JSON. 





正如 Go 语言 提供 对 XML 的 支持 一 样 ，Go 语 言 也 通过 
encoding/json 库 提 供 对 JSON 的 支持 。 和 上 一 市 一 样 ， 我 们 首先 会 学 


习 如 何 分 析 JSON， 然 后 再 学 习 如 何 创建 JSON 数 据 。 


7.5.1 分 析 JSON 





分 析 JSON 的 步骤 和 分 析 XML 的 步骤 基本 相同 一 一 分 析 程 序 首 移 要 
做 的 就 是 把 JSON 的 分 析 结 果 存 储 到 一 些 结构 里 面 ， 然 后 通过 访问 这 些 
结构 来 提取 数据 。 下 面 是 分 析 JSON 的 两 个 常见 步骤 《这 个 过 程 如 图 7-7 
EDE 








图 7-7 使 用 Go 分 析 JSON: 创建 结构 并 将 JSON 解 封 到 结构 里 面 





(1) 创建 一 些 用 于 包含 JSON 数 据 的 结构 ; 
(2) 通过 json.Unmarshal 函数 ， 把 JSON 数 据 解 封 到 结构 里 面 。 


跟 映 射 XML 相 比 ， 把 结构 映射 至 JSON 要 简单 得 多 ， 后 者 只 有 一 条 
通用 的 规则 : 对 于 名 字 为 <name> 的 JSON 键 ， 用 户 只 需要 在 结构 里 创建 
一 个 任意 名 字 的 字段 ， 并 将 该 字段 的 结构 标签 设置 为 'json:" 
<name>"', 就 可 以 把 JSON 键 <namey> 的 值 存储 到 这 个 字段 里 面 。 接 下 
来 ， 就 让 我 们 来 看 一 个 实际 的 例子 。 











代码 清单 7-9 展 示 了 一 个 名 为 post .json 的 JSON 文 件 ， 我 们 接 下 来 
就 要 对 这 个 文件 进行 分 析 。 因 为 这 个 JSON 文 件 包含 的 数据 跟 之 前 分 析 
的 XML 文件 包含 的 数据 是 相同 的 ， 所 以 这 些 数据 对 你 来 说 应 该 不 会 感 


到 陌生 。 








代码 清单 7-9 ”要 分 析 的 JSON 文 件 

















{ 
"id pL, 
"content" : "Hello World!", 


”2: "Sau Sheong" 


"comments" : [ 


"id" : 3, 
"content" : “Have a great day!", 


"author" : "Adam" 


"id" : 4, 
"content" : “How are you today?", 
"author" : "Betty" 





Wiis 7-10 7 Y json. go XF 包含 的 代码 ， 这 些 代码 会 分 析 
post.json 文件 ， 并 将 其 包含 的 JSON 数 据 解 封 至 相应 的 结构 。 需 要 注 
意 的 是 ， 除 了 结构 标签 之 外 ， 这 个 程序 使 用 的 结构 跟 之 前 分 析 XML 时 
使 用 的 结构 并 无 不 同 。 


代码 清单 7-10 ” JSON 分 析 程 序 











package main 


import ( 
"encoding/json" 
" fmt n" 
"io/ioutil" 
"os "n" 


) 


type Post struct { 


Id int `json: "id @ 
Content string ` json: "content" 
Author Author ` json: "author"` 
Comments []Comment `json:"comments"` 
} 
type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 
func main() { 
jsonFile, err := os.Open("post.json") 
if err != nil { 
fmt.Println("Error opening JSON file:", err) 
return 
} 


defer jsonFile.Close() 
jsonData, err := ioutil.ReadAll(jsonFile) 


if err != nil { 
fmt.Println("Error reading JSON data:", err) 
return 

} 


var post Post 
json.Unmarshal(jsonData, &post) @ 
fmt.Println(post) 





@ 定义 一 些 结构 ， 用 于 表示 数据 


四 ISON 数据 解 封 至 结构 


为 了 将 JSON 键 id 的 值 映射 到 Post 结构 的 Id 字段 ， 程 序 将 该 字段 
的 结构 标签 设置 成 了 'json:"id"'， 这 种 设置 基本 上 就 是 将 结构 映射 
至 JSON 数 据 所 需 完 成 的 全 部 工作 。 跟 分 析 XML 时 一 样 ， 分 析 程 序 通过 
切片 来 散 套 多 个 结构 ， 从 而 使 一 篇 帖子 可 以 包含 零 个 或 多 个 评论 。 除 此 
之 外 ，JSON 的 解 封 操 作 也 跟 XML 的 解 封 操 作 一 样 ， 都 可 以 通过 调 
用 Unmarshal 函数 来 完成 。 





我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 分 析 程 序 : 


如 果 一 切 正常 ， 应 该 会 看 到 以 下 结 


{1 Hello World! {2 Sau Sheong} [{3 Have a great day! Adam} {4 How are you 
today? Betty}]} 





跟 分 析 XML 时 一 样 ， 用 户 除 了 可 以 使 用 Unmarshal eh BOK AES 
JSON， 还 可 以 使 用 Decoder 手动 地 将 JSON 数 据 解 码 到 结构 里 面 ， 以 此 
来 处 理 流 式 的 JSON 数 据 ， 图 7-8 以 及 代码 清单 7-11 展 示 了 这 个 过 程 的 有 具 
体 实 现 。 


创建 出 用 于 存储 创建 出 用 于 解码 过 历 整个 ISON 


JSON 数 据 的 结构 JSON 数 据 的 解码 器 ee 





图 7-8 ”使 用 Go 分 析 JSON: 将 JSON 解 码 至 结构 





代码 清单 7-11 使 用 Decoder 对 JSON 进 行 语言 分 析 





jsonFile, err := os.Open("post.json") 

if err != nil { 
fmt.Println("Error opening JSON file:", err) 
return 

} 

defer jsonFile.Close() 


decoder := json.NewDecoder(jsonFile) @ 
for { @ 
var post Post 
err := decoder.Decode(&post) © 
if err == io.EOF { 
break 
} 
if err != nil { 
fmt.Println("Error decoding JSON:", err) 
return 


fmt.Println(post) 
} 





@ 根据 给 定 的 JSON 文件 ， 创 建 出 相应 的 解码 器 
© 遍历 JSON 文件 ， 直 到 遇见 EOF Wik 
O ISON 数据 解码 至 结构 


通过 调用 NewDecoder 并 传 入 一 个 包含 JSON 数 据 的 io.Reader , 
程序 创建 出 了 一 个 新 的 解码 器 。 在 把 指向 Post 结构 的 引用 传递 给 解码 
器 的 Decode 方法 之 后 ， 被 传 入 的 结构 就 会 填充 上 相应 的 数据 ， 然 后 这 
些 数据 就 可 以 为 程序 所 用 了 。 当 所 有 JSON 数 据 都 被 解码 完毕 
KY, Decode 方法 将 会 返回 一 个 EOF ， 而 程序 则 会 在 检测 到 这 个 EOF 之 
后 退出 for 循环 。 


我 们 可 以 通过 执行 以 下 命令 来 运行 这 个 JSON 解 码 器 : 


如 果 一 切 正常 ， 将 会 看 到 以 下 结果 : 


{1 Hello World! {2 Sau Sheong} [{1 Have a great day! Adam} {2 How are you 
today? Betty}]} 


最 后 ， 在 面 对 JSON 数 据 时 ， 我 们 可 以 根据 输入 决定 使 用 Decoder 
还 是 Unmarshal : 如 果 JSON 数 据 来 源 于 io.Reader 流 ， 如 
http.Request 的 Body ， 那 么 使 用 Decoder 更 好 ; 如 果 JSON 数 据 来 源 
于 字符 串 或 者 内 存 的 某 个 地 方 ， 那 么 使 用 Unmarshal 更 好 。 





7.5.2 ”创建 JSON 


正如 上 一 个 小 节 所 示 ， 分 析 JSON 的 方法 和 分 析 XML 的 方法 是 非常 
相似 的 。 同 样 地 ， 如 图 7-9 所 示 ， 创 建 JSON 的 方法 和 创建 XML 的 方法 也 
是 相似 的 。 





图 7-9 ”使 用 Go 创建 JSON: 创建 结构 并 将 其 封装 为 JSON 数 据 


代码 清单 7-12 展 示 了 把 Go 纺 构 封 效 为 JSON 数 据 的 具体 代码 。 


代码 清单 7-12 ”将 结构 封装 为 JSON 





package main 


import ( 
"encoding/json" 
"fmt" 
"io/ioutil" 


type Post struct { @ 
Id int ~json:"id"~ 
Content string ~json: "content" 
Author Author ~json: "author" 
Comments []Comment ~json:"comments"~ 


} 


type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content"` 
Author string ~ json: "author" 


} 


func main() { 
post := Post{ 
Id: 1, 
Content: "Hello World!", 
Author: Author{ 
Id: 2; 
Name: "Sau Sheong", 


}s 
Comments: [ ]Comment{ 
Comment { 
Id: 3, 
Content: "Have a great day!", 
Author: "Adam", 
}s 
Comment { 


Id: 4, 
Content: "How are you today", 
Author: "Betty", 
Js 
}s 


output, err := json.MarshalIndent(&post, "", "\t\t") @ 
if err != nil { 

fmt.Println("Error marshalling to JSON:", err) 

return 


err = ioutil.WriteFile("post.json", output, 0644) 
if err != nil { 
fmt.Printin("Error writing JSON to file:", err) 
return 
} 
} 





@ 创建 结构 并 向 里 面 填充 数据 





O 把 结构 封装 为 由 字 节 切片 组 成 的 JSON 数据 


跟 处 理 XML 时 的 情况 一 样 ， 这 个 封装 程序 使 用 的 结构 和 之 前 分 析 
JSON 时 使 用 的 结构 是 相同 的 。 程 序 首 先 会 创建 一 些 结构 ， 然 后 通过 调 
用 MarshalIndent 函数 将 结构 封装 为 由 字 市 切片 组 成 的 JSON 数 据 
(json 库 的 MarshalIndent 函数 和 xml 库 的 MarshalIndent 函数 的 作 

用 是 类 似 的 ) 。 最 后 ， 程 序 会 将 封装 所 得 的 JSON 数 据 存 储 到 指定 的 文 
FEE 











正如 我 们 可 以 通过 编码 器 手动 创建 XML 一 样 ， 我 们 也 可 以 通过 编 
强手 动 将 Go 结构 编码 为 JSON 数 据 ， 图 7-10 展 示 了 这 个 过 程 


创建 出 用 于 存储 通过 编码 器 把 
创建 创建 出 用 于 编码 
JSON 数 据 的 结构 编码 至 
pa RESER a JSON 数 据 的 编码 器 re 


图 7-10 ”使 用 Go 创建 JSON 数 据 : 通过 编码 器 把 结构 编码 为 JSON 






































代码 清单 7-13 展 示 了 json.go 文 件 中 包含 的 代码 ， 这 些 代码 可 以 根 
据 给 定 的 Go 结构 创建 相应 的 JSON 文 件 。 





代码 清单 7-13 ”使 用 Encoder 把 结构 编码 为 JSON 








package main 


import ( 
"encoding/json" 
"fmt" 
"io" 
"os" 
) 
type Post struct { @ 
Id int `json: "id" 
Content string `json:"content"` 
Author Author `json:"author"` 
Comments []Comment `json:"comments"` 
} 
type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 


func main() { 


post := Post{ 
Id: 1, 
Content: "Hello World!", 
Author: Author{ 
Id: 2; 
Name: "Sau Sheong", 
}s 
Comments: [ ]Comment{ 
Comment { 
Id: 3, 
Content: "Have a great day!", 


Author: "Adam", 
Jo 
Comment{ 

Id: 4, 

Content: "How are you today?", 

Author: "Betty", 


}s 
hs 
3 
jsonFile, err := os.Create("post.json") @ 
if err != nil { 
fmt.Println("Error creating JSON file:", err) 
return 
} 
encoder := json.NewEncoder(jsonFile) © 
err = encoder .Encode(&post) 
if err != nil { 9 
fmt.Println("Error encoding JSON to file:", err) 
return 
} 
} 





@ 创建 结构 并 向 里 面 填充 数据 


O 创建 用 于 存储 数据 的 JSON 文件 
© 根据 给 定 的 JSON 文 件 创建 出 相应 的 编码 器 
O 把 结构 编码 到 JSON 文 件 里 面 


跟 之 前 一 样 ， 程 序 会 创建 一 个 用 于 存储 JSON 数 据 的 JSON 文 件 ， 并 
通过 把 这 个 文件 传递 给 NewEncoder 函数 来 创建 一 个 编码 器 。 接 着 ， 程 
子 会 调用 编码 器 的 Encode 方法 ， 并 同 其 传递 一 个 指 疝 Post 结构 的 引 
用 。 在 此 之 后 ，Encode 方法 会 从 结构 里 面 提取 数据 并 将 其 编码 为 JSON 
数据 ， 然 后 把 这 些 JSON 数 据 写 入 创建 编码 器 时 给 定 的 JSON 文 件 里 面 。 


关于 分 析 和 创建 XML 和 JSON 的 介绍 到 这 里 就 结束 了 。 虽 然 最 近 这 
两 节 介绍 的 内 容 可 能 会 因为 模式 相似 而 显得 有 些 乏 味 ， 但 这 些 基 础 知识 
对 于 接 下 来 的 一 节 学 习 如 何 创建 Go Web 服 务 是 不 可 或 缺 的 ， 因 此 花 时 
间 学 习 和 掌握 这 些 知 识 是 非常 值得 的 。 





7.6 创建 Go Web 服 务 


创建 Go Web 服 务 并 不 是 一 件 困难 的 事情 : 如 果 你 仔细 地 阅读 并 理 
解 了 前 面 各 个 章节 介绍 的 内 容 ， 那 么 掌握 接 下 来 要 介绍 的 知识 对 你 来 说 
应 该 是 轻而易举 的 。 





本 节 将 要 构建 一 个 简单 的 基于 REST 的 Web 服 务 ， 它 允许 我 们 对 论 
坛 帖子 执行 创建 、 获 取 、 更 新 以 及 删除 操作 。 上 有 具体 来 说 ， 我 们 将 会 使 用 
第 6 章 介 绍 过 的 CRUD 函 数 来 包 右 起 一 个 web 服 务 接口， 并 通过 JSON 格 
式 来 传输 数据 。 除 了 本 章 之 外 ， 后 续 的 章节 也 会 沿用 这 个 Web 服 务 作为 
例子 ， 对 其 他 概念 进行 介绍 。 


代码 清单 7-14 展 示 了 实现 Web 服 务 需要 用 到 的 数据 库 操 作 ， 这 些 操 
作 和 6.4 节 介绍 过 的 操作 基本 相同 ， 只 是 做 了 一 些 简 化 。 这 些 代码 定义 
了 Web 服 务 需 要 对 数据 库 执行 的 所 有 操作 ， 它 们 都 隶属 于 main 包 ， 并 
且 被 放置 到 了 data.go 文 件 中 。 








代码 清单 7-14 ”使 用 data.go 访问 数据 库 








package main 


import ( 

"database/sql" 

_ "github.com/1lib/pq" 
) 


var Db *sql.DB 


func init() { ©@ 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp sslmode 


disable") 
if err != nil { 
panic(err) 
} 
} 


func retrieve(id int) (post Post, err error) { @ 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = $1", 
id).Scan(&post.Id, &post.Content, &post.Author) 


return 
} 
func (post *Post) create() (err error) { © 

statement := "insert into posts (content, author) values ($1, $2) return 
ing 

id" 

stmt, err := Db.Prepare(statement) 

if err != nil { 

return 
} 


defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


} 


func (post *Post) update() (err error) { @ 
_, err = Db.Exec("update posts set content = $2, author = $3 where id = 
$1", post.Id, post.Content, post.Author) 
return 


} 


func (post *Post) delete() (err error) { © 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 


} 





@ 连接 到 数据 库 


O 获取 指定 的 帖子 


© 创建 一 篇 新 帖子 


O 更 新 指定 的 帖子 
© 删除 指定 的 帖子 


正如 所 见 ， 这 些 代 码 跟 前 面 代 码 清单 6-6 展 示 过 的 代码 非常 相似 ， 
古 在 图 数 名 和 方法 名 上 稍 有 区 别 ， 因 此 我 们 在 这 里 束 不 再 一 一 解释 
。 如 果 你 需要 重 温 一 下 这 些 代码 的 作用 ， 那 么 可 以 去 复习 一 下 6.4 








#4 Woo 





在 拥有 了 对 数据 库 执行 CRUD 操 作 的 能 力 之 后 ， 让 我 们 来 学 习 一 下 
如 何 实现 真正 的 web 服务 。 代 码 清单 7-15 展 示 了 整个 web 服 务 的 实现 代 
码 ， 这 些 代 码 保存 在 文件 server .go 中 。 








代码 清单 7-15 ”定义 在 server .go 文件 内 的 Go Web 服 务 





package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 


) 


type Post struct { 
Id int `json: "id" 
Content string `json:"content"` 
Author string ~json: "author" 


} 


func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 


} 
http.HandleFunc("/post/", handleRequest) 
server.ListenAndServe() 


} 


func handleRequest(w http.ResponseWriter, r *http.Request) { @ 
var err error 
switch r.Method { 


case "GET": 

err = handleGet(w, r) 
case "POST": 

err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err = handleDelete(w, r) 


} 
if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 
} 
} 


func handleGet(w http.ResponsewWriter, r *http.Request) (err error) { @ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 
} 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 


} 


func handlePost(w http.Responsewriter, r *http.Request) (err error) { © 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) 
var post Post 
json.Unmarshal(body, &post) 
err = post.create() 
if err != nil { 
return 


} 
w.WriteHeader (200) 


return 


} 


func handlePut(w http.Responsewriter, r *http.Request) (err error) { @ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 


len := r.ContentLength 

body := make([]byte, len) 
r.Body .Read (body) 
json.Unmarshal(body, &post) 
err = post.update() 


if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


} 


func handleDelete(w http.ResponsewWriter, r *http.Request) (err error) { © 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 

} 

post, err := retrieve(id) 

if err != nil { 
return 

} 

err = post.delete() 

if err != nil { 
return 

} 

w.WriteHeader (200) 

return 





O 多 路 复 用 器 负责 将 请 求 转发 给 正确 的 处 理 器 函数 


O 获取 指定 的 帖子 
O 创建 新 的 帖子 
O 更 新 指定 的 帖子 


© 删除 指定 的 帖子 





这 段 代 码 的 结构 非常 直观 : handleRequest 多 路 复 用 器 会 根据 请 
求 使 用 的 HTTP 方 法 ， 把 请 求 转 及 给 相应 的 CRUD 处 理 右 函数 ， 这 些 函 
数 都 接受 一 个 ResponseNriter 和 一 个 Request 作为 参数 ， 并 返回 可 能 
出 现 的 错误 作为 函数 的 执行 结果 ; handleRequest 会 检查 这 些 函 数 的 
执行 结果 ， 并 在 发 现 错误 时 通过 StatusInternalServerError 返回 一 
个 500 状 态 码 。 





接 下 来 ， 让 我 们 首先 从 帖子 的 创建 操作 开始 ， 对 Go Web 服 务 的 各 
个 部 分 进行 详细 的 解释 ，handlePost 函数 如 代码 清单 7-16 所 示 。 
































代码 清单 7-16 用 于 创建 帖子 的 函数 











func handlePost(w http.ResponseWriter, r *http.Request) (err error) { 
len := r.ContentLength 
body := make([]byte, len) ee 
r.Body.Read(body) 
var post Post 
json.Unmarshal(body, &post) © 
err = post.create() @ 
if err != nil { 
return 


w.WriteHeader (200) 
return 





O 读 取 请 求 主体 ， 并 将 其 存储 在 字 节 切片 中 ; @ 创 建 一 个 字 市 切片 
© 把 切片 存储 的 数据 解 封 至 Post 结构 
O 创建 数据 库 记 录 


handlePost 函数 首先 会 根据 内 容 的 长 度 创 建 出 一 个 字 节 切片 ， 然 
后 将 请 求 主体 记录 的 JSON 字 符 串 读 取 到 字 节 切片 里 面 。 之 后 ， 函 数 会 
声明 一 个 Post 结构 ， 并 将 字 节 切片 存储 的 内 容 解 封 到 这 个 结构 里 面 。 
这 样 一 来 ， 函 数 就 拥有 了 一 个 填充 了 数据 的 Post 结构 ， 于 是 它 调用 结 
构 的 Create 方法 ， 把 记录 在 结构 中 的 数据 存储 到 了 数据 库 里 面 。 





为 了 调用 Web 服 务 ， 我 们 需要 用 到 第 3 章 介绍 过 的 cURL， 并 在 终 站 
中 执行 以 下 命令 : 


curl -i -X POST -H "Content-Type: application/json" -d '{"content":"My fi 
rst 


post", "author":"Sau Sheong"}' http://127.0.0.1:8080/post/ 





这 个 命令 首先 会 把 Content-Type 首部 设置 为 application/json 
， 然 后 通过 POST 方法 ， 向 地 址 http://127.6.6.1/post/ 发 送 一 条 主 
体 为 JSON 字 符 串 的 HITP 请 求 。 如 果 一 切 顺 利 ， 应 该 会 看 到 以 下 结果 : 
HTTP/1.1 200 OK 


Date: Sun, 12 Apr 2015 13:32:14 GMT 
Content-Length: 6 


Content-Type: text/plain; charset=utf-8 





不 过 这 个 结果 只 能 证 明 处 理 器 函数 在 处 理 这 个 请 求 的 时 候 没 有 发 生 


任何 错误 ， 却 无 法 说 明 帖 子 真 的 已 经 创建 成 功 了 。 为 了 验证 这 一 点 ， 我 
们 需要 通过 执行 以 下 SQL 碍 询 来 检视 一 下 数据 库 : 


psql -U gwp -d gwp -c "Select * from posts;" 


如 果 帖 子 创建 成 功 了 ， 应 该 会 看 到 以 下 结果 : 








1 | My first post | Sau Sheong 


(1 row) 





除了 handlePost 函数 之 外 ， 我 们 的 Web 服 务 的 每 个 处 理 器 函数 都 
会 假设 目标 帖子 的 id 已 经 包含 在 了 URL 里 面 。 比 如 说 ， 当 用 户 想 要 获 
取 一 篇 帖子 时 ，Web 服 务 接收 到 的 请 求 应 该 指 癌 以 下 URL: 


/post/<id> 


而 这 个 URL 中 的 <id> 记录 的 束 是 帖子 的 id 。 代 码 清单 7-17 展 示 了 函数 
是 如 何 通 过 这 一 机 制 来 获取 帖子 的 。 














代码 清单 7-17 用 于 获取 帖子 的 函数 





























func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path)) 
if err != nil { 
return 
} 
post, err := retrieve(id) @ 
if err != nil { 
return 


} 

output, err := json.MarshalIndent(&post, "", "\t\t") @ 
if err != nil { 

return 
} 

w.Header().Set("Content-Type", "application/json") © 
w.Write(output) 
return 





@ 从 数据 库 里 获取 数据 ， 并 将 其 填充 到 Post 结构 中 


© 把 Post 结构 封装 为 JSON 字符 串 
© 把 JSON 数据 写 入 ResponseWriter 


handleGet 函数 首先 通过 path.Base 函数 ， 从 URE 的 路 径 中 提取 
出 字符 串 格 式 的 帖子 id ， 接 着 使 用 strconv.Atoi 函数 把 这 个 id 转换 
成 整数 格式 ， 然 后 通过 把 这 个 id 传递 给 retrivePost 函数 来 获得 填充 
了 帖子 数据 的 Post 结构 。 


在 此 之 后 ， 程 序 通过 json.MarshalIndent 函数 ， 把 Post 结构 转 
换 成 了 JSON 格 式 的 字 节 切片 。 最 后 ， 程 序 把 Content -Type 首部 设置 
成 了 application/json ， 并 把 字 节 切片 中 的 JSON 数 据 写 
入 ResponseWriter ， 以 此 来 将 JSON 数 据 返回 给 调用 者 。 





为 了 观察 handleGet 函数 是 如 何 工作 的 ， 我 们 需要 在 终端 里 面 执行 
以 下 命令 : 


curl -i -X GET http://127.0.0.1:8080/post/1 


这 条 命令 会 回 给 be a 请 求 ， 笠 试 获取 id 为 1 的 帖 
子 。 如 果 一 切 正常 ， 那 么 这 条 命令 应 该 会 返回 以 下 结 


HTTP/1.1 200 OK 

Content-Type: application/json 
Date: Sun, 12 Apr 2015 13:32:18 GMT 
Content-Length: 69 


{ 
me Ly 
"content": “My first post", 
"author": "Sau Sheong" 








在 更 新 帖子 的 时 候 ， 程 序 同样 需要 先 获取 帖子 的 数据 ， 具 体 细节 如 
代码 清单 7-18 所 示 。 


























代码 清单 7-18 用 于 更 新 帖子 的 函数 




















func handlePut(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) @ 
if err != nil { 
return 
} 


len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body) @ 
json.Unmarshal(body, &post) © 
err = post.update() @ 


if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


Pt 
@ 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 








O 从 请 求 主体 中 读 取 JSON 数据 
© 把 JSON 数据 解 封 至 Post 结构 
O 对 数据 库 进 行 更 新 


在 更 新 帖子 时 ，handlepPut 函数 首先 会 获取 指定 的 帖子 ， 然 后 再 根 
据 PUT 请 求 发 送 的 信息 对 帖子 进行 更 新 。 在 获取 了 帖子 对 应 的 Post 结 
构 之 后 ， 程 序 会 读 取 请 求 的 主体 ， 并 将 主体 中 的 内 容 解 封 至 Post 结 
构 ， 最 后 通过 调用 Post 结构 的 update 方法 更 新 帖子 。 


通过 在 终端 里 面 执 行 以 下 命令 ， 我 们 可 以 对 之 前 创建 的 帖子 进行 更 
新 : 


curl -i -X PUT -H "Content-Type: application/json" -d '{"content": "Updated 


post", "author":"Sau Sheong"}' http://127.0.0.1:8080/post/1 








要 通过 URL 来 指定 被 更 新 帖子 的 ID。 如 果 一 切 正 常 ， 这 条 命令 应 该 会 返 
回 以 下 结果 : 





HTTP/1.1 200 OK 

Date: Sun, 12 Apr 2015 14:29:39 GMT 
Content-Length: 6 

Content-Type: text/plain; charset=utf-8 


Pt 
现在 ， 我 们 可 以 通过 再 次 执行 以 下 SQL 查询 来 确认 更 新 是 否 已 经 成 








功 : 


psql -U gwp -d gwp -c "select * from posts;" 


如 无 意外 ， 应 该 会 看 到 以 下 内 容 : 


1 | Updated post | Sau Sheong 


(1 row) 





代码 清单 7-19 展 示 了 Web 服 务 的 帖子 删除 操作 的 实现 代码 ， 这 些 代 
码 会 先 获 取 指 定 的 帖子 ， 然 后 通过 调用 delete 方法 来 删除 帖子 。 














代码 清单 7-19 用 于 删除 帖子 的 函数 





























func handleDelete(w http.ResponsewWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 

return 
} 

post, err := retrieve(id) @ 
if err != nil { 

return 
} 

err = post.delete() @ 
if err != nil { 

return 
} 
w.WriteHeader (200) 
return 


} 


[L E 








@ 从 数据 库 里 获取 指定 帖子 的 数据 ， 并 将 其 填充 至 Post 结构 


O 从 数据 库 里 删除 这 个 帖子 








注意 ， 无 论 是 更 新 帖子 还 是 删除 帖子 ，Web 服 务 在 操作 执行 成 功 时 
都 会 返回 200 状 态 码 。 但 是 ， 如 果 处 理 器 函数 在 处 理 请 求 时 出 现 了 任何 
音 误 ， 那 么 该 错误 将 被 返回 至 handleRequest 多 路 复 用 器 ， 然 后 由 多 
路 复 用 器 向 客户 端 返回 一 个 500 状 态 码 。 


通过 执行 下 面 的 cURL 调用 ， 我 们 可 以 删除 前 面 创建 的 帖子 : 


curl -i -X DELETE http://127.0.0.1:8080/post/1 


如 果 一 切 正 常 ， 那 么 这 个 cURL 调用 将 返回 以 下 结果 : 


HTTP/1.1 200 OK 
Date: Sun, 12 Apr 2015 14:38:59 GMT 
Content-Length: 6 


Content-Type: text/plain; charset=utf-8 





现在 ， 如 果 我 们 再 次 执行 之 前 的 SQL 得 询 ， 就 会 发 现 之 前 创建 的 帖 
子 已 经 不 复 存 在 了 : 





id | content | author 





7.7 Si 





。 编写 Web 服务 是 Go 语言 目前 非常 常见 的 用 途 之 一 ， 了 解 如 何 构建 
Web 服 务 是 一 项 非常 有 价值 的 技能 。 

© Web 服 务 主要 分 为 两 种 类 型 一 一 一 种 是 基于 SOAP 的 Web 服 务 ， 而 
另 一 种 则 是 基于 REST 的 Web 服 务 。 

o SOAP 是 一 种 协议 ， 它 能 够 对 定义 在 XML 中 的 结构 化 数据 进行 
交换 。 但 是 ， 因 为 SOAP 的 WSDL 报 文 有 可 能 会 变 得 非常 复 
杂 ， 上 所 以 基于 SOAP 的 Web 服 务 没有 基于 REST 的 Web 服 务 那么 
流行 。 
基于 REST 的 Web 服 务 通过 HTTP 协 议 向 外 界 公开 自己 拥有 的 资 
源 ， 并 允许 外 界 通 过 HTTP 协 议 对 这 些 资源 执行 指定 的 动作 。 
。 创建 和 分 析 XML 以 及 JSON 的 步骤 都 是 相似 的 ， 用 户 要 么 根据 指定 

的 结构 去 生成 XML 或 者 JSON， 要 么 从 指定 的 结构 里 面 提取 数据 到 
XML 或 者 JSON 里 面 ， 前 一 种 操作 称 为 封装 ， 而 后 一 种 操作 则 称 为 
解 封 。 








ie) 


[1] SOAP API 的 搜集 结果 可 以 通过 访问 
www.programmableweb.com/category/all/apis?data_format=21176 查看 ， 
而 REST API 的 搜集 结果 可 以 通过 访问 


www.programmableweb.com/category/all/apis?data_format= 21190 碍 看 。 


[2] 具体 化 指 的 是 将 抽象 的 概念 转换 为 实际 的 数据 模型 或 对 象 。 一 i$ 
者 注 


第 8 草 ”应 用 训 试 


本 章 主要 内 容 


。 Go 语言 的 testing 库 
。 单元 测试 

。 HTTP 测 试 

。 使 用 依赖 注入 进行 测试 
。 使 用 第 三 方 测试 库 


测试 是 编程 工作 中 非常 重要 的 一 环 ， 但 很 多 人 却 忽视 了 这 一 点 ， 叉 
或 者 只 是 把 测试 看 作 是 一 种 可 有 可 无 的 补充 手段 。Go 语 言 提 供 了 一 些 
基本 的 测试 功能 ， 这 些 功 能 初 看 上 去 可 能 会 显得 非常 原始 ， 但 正如 本 章 
将 要 介绍 的 那样 ， 这 些 工具 实际 上 己 经 能 够 满足 程序 员 对 自动 测试 的 需 
要 了 。 除 了 Go 语言 内 置 的 testing 包 之 外 ， 本 章 还 会 介绍 check 和 
Ginkgo 这 两 个 流行 的 Go 测试 包 ， 它 们 提供 的 功能 比 testing 包 更 为 丰 








mi} 


跟前 面 章 市 介绍 过 的 Web 应 用 编程 库 一 样 ，Go 语 言 的 测试 库 也 只 所 
供 了 基本 的 工具 ， 而 程序 员 要 做 的 就 是 在 这 些 工 具 的 基础 上 ， 构 建 出 能 
够 满足 目 己 需求 的 测试 。 





8.1 Go 与 测试 


Go 的 标准 库 提供 了 几 个 与 测试 有 关 的 库 ， 其 中 最 主要 的 是 testing 
包 ， 本 章 介 绍 的 绝 大 部 分 测试 功能 都 来 源 于 这 个 
包 。net/http/httptest 包 是 另 一 个 与 Web 应 用 编程 有 关 的 库 ， 这 个 
库 是 基于 testing 库 实 现 的 。 正 如 它 的 名 字 所 示 ，httptest 包 是 一 个 
用 于 测试 Web 应 用 的 库 。 


因为 testing 包 提 供 了 在 Go 中 实现 基本 的 自动 测试 的 能 力 ， 所 以 
本 章 会 先 介绍 testing 包 ， 等 读者 了 解 了 testing 包 之 后 ， 再 学 
习 httptest 包 就 会 有 事半功倍 的 效果 。 


testing 包 需 要 与 go test 命令 以 及 源 代 码 中 所 有 以 _test.go 后 
绥 结 尾 的 测试 文件 一 同 使 用 。 尽 管 Go 并 没有 强制 要 求 ， 但 一 般 来 说 ， 
测试 文件 的 名 字 都 会 与 被 测试 源码 文件 的 名 字 相 对 应 。 


举 个 例子 ， 对 于 源码 文件 server.go ， 我 们 可 以 创建 出 一 个 名 
为 server_test.go 的 测试 文件 ， 这 个 测试 文件 包含 我 们 想 对 
server. go 进行 的 所 有 测试 。 男 外 需要 注意 的 一 点 是 ， 被 测试 的 源码 文 
件 和 测试 文件 必须 位 于 同一 个 包 之 内 。 


为 了 测试 源 代码 ， 用 户 需 要 在 测试 文件 中 创建 具有 以 下 格式 的 测试 
函数 ， 其 中 Xxx 可 以 是 任意 英文 字母 以 及 数字 的 组 合 ， 但 是 首 字符 必须 
是 大 写 的 英文 字母 ， 


func TestXxx 








(*testing.T) { ... } 


在 测试 函数 的 内 部 ， 用 户 可 以 使 用 Error . Fail 等 一 系列 方法 表 
示 测 试 失 败 。 当 用 户 在 终端 里 面 执行 go test 命令 的 时 候 ， 所 有 符合 上 
述 格式 的 测试 函数 就 会 被 执行 。 如 果 一 个 测试 在 执行 时 没有 出 现任 何 失 
败 ， 那 么 我 们 就 说 函数 通过 了 测试 。 接 下 来 ， 就 让 我 们 实际 地 学 习 如 何 
使 用 testing 包 进 行 测试 。 


8.2 ”使 用 Go 进行 单元 测试 


顾名思义 ， 单 元 测试 Cunit test) ， 束 是 一 种 为 验证 单元 的 正确 性 而 
设置 的 自动 化 测试 ， 一 个 单元 就 是 程序 中 的 一 个 模块 化 部 分 。 一 般 来 
说 ， 一 个 单元 通常 会 与 程序 中 的 一 个 函数 或 者 一 个 方法 相对 应 ， 但 这 并 
不 是 必须 的 。 程 序 中 的 一 个 部 分 能 否 独立 地 进行 测试 ， 是 评判 这 个 部 分 
能 人 否 被 归纳 为 “单元 ”的 一 个 重要 指标 。 一 个 单元 通 意 会 接受 数据 作为 输 
入 并 返回 相应 的 输出 ， 而 单元 测试 用 例 要 做 的 就 是 同 单元 传 入 数据 ， 然 
后 检查 单元 产生 的 输出 是 否 符 合 预期 。 单 元 测试 通常 会 以 测试 套件 

(test suite) 的 形式 运行 ， 后 者 是 为 了 验证 特定 行为 而 创建 的 单元 测试 
用 例 集 合 。 





Go 的 单元 测试 会 按照 功能 分 组 ， 并 放置 在 以 _test.go 为 后 级 的 文 
件 当 中 。 作 为 例子 ， 我 们 接 下 来 要 考虑 的 是 如 何 对 代码 清单 8-1 所 示 的 
main.go 文 件 中 的 decode 函数 进行 测试 。 


代码 清单 8-1 一 个 JSON 数 据 解码 程序 











package main 


import ( 
"encoding/json" 
"fmt" 
"os" 

) 

type Post struct { 
Id int `json: "id" 
Content string ` json: "content" 
Author Author ` json: "author"` 


Comments []Comment `json:"comments™` 


} 


type Author struct { 
Id int `json: "id" 
Name string `json:"name"` 


} 


type Comment struct { 
Id int `json: "id" 
Content string `json:"content"` 
Author string ~json: "author" 


} 
func decode(filename string) (post Post, err error) { @ 
jsonFile, err := os.Open(filename) @ 
if err != nil { o 
fmt.Println("Error opening JSON file:", err) @ 
return @ 
} @ 
defer jsonFile.Close() @ 
decoder := json.NewDecoder(jsonFile) ©@ 
err = decoder.Decode(&post) @ 
if err != nil { o 
fmt.Println("Error decoding JSON:", err) @ 
return @ 
}@ 
return @ 
}@ 
func main() { @ 
_, err := decode("post.json") @ 
if err != nil { 
fmt.Println("Error:", err) 
} 


} 





@ 将 负责 解码 的 代码 重 构 到 单独 的 解码 函数 中 


这 个 程序 复 用 了 之 前 在 代码 清单 7-8 和 代码 清单 7-9 中 展示 过 的 JSON 
解码 程序 ， 但 是 它 并 没有 像 昌 程序 那样 把 所 有 逻辑 都 放 到 main 函数 里 
面 ， 而 是 将 旧 程 序 中 负责 打开 文件 并 对 其 进行 解码 的 部 分 重 构 到 了 单独 








decode 函数 里 面 ， 然 后 再 在 main 函数 中 调用 decode 函数 。 需 要 注 
意 的 是 ， 虽 然 程 序 员 在 大 部 分 时 间 里 关注 的 都 是 如 何 编写 代码 从 而 实现 
特性 并 交付 功能 ， 但 写 出 可 测试 的 代码 同样 也 是 非常 重要 的 。 为 了 做 到 
这 一 点 ， 程 序 员 通常 需要 在 编写 程序 之 前 对 程序 的 设计 进行 思考 ， 并 把 
测试 看 作 是 软件 开发 的 重要 一 环 ， 本 章 稍 后 将 对 这 一 点 进行 更 详细 的 说 
明 。 


























代码 清单 8-2 展 示 了 我 们 将 要 解码 的 JSON 文 件 ， 它 跟 第 7 章 中 被 解 
码 的 JSON 文 件 是 完全 一 样 的 。 











代码 清单 8-2 ”被 解码 的 post.json 文件 

















{ 
"Ld 1, 
"content" : "Hello World!", 


" : "Sau Sheong" 


"comments" : [ 


"id" : 3; 
"content" : “Have a great day!", 
"author" : "Adam" 


"id" : 4, 
"content" : “How are you today?", 
"author" : "Betty" 





代码 清单 8-3 展 示 了 负责 测试 nain .go 文件 的 main_test .go 文件 





























代码 清单 8-3 main. go 进行 测试 的 main_test.go 文件 











package main @ 


import ( 
"testing" 
) 


func TestDecode(t *testing.T) { 
post, err := decode("post.json") @ 
if err != nil { 
t.Error(err) 
} 
if post.Id !=1{ © 
t.Error("Wrong id, was expecting 1 but got", post.Id) © 
} © 
if post.Content != "Hello World!" { 6 
t.Error("Wrong content, was expecting ‘Hello World!" but got", 
=post.Content) 
} 


} 
func TestEncode(t *testing.T) { 


t.Skip("Skipping encoding for now") @ 
} 





@ 测试 文件 与 被 测试 的 源 代码 文件 位 于 同一 个 包 内 

© 调用 被 测试 的 函数 

O 检查 结果 是 否 和 预期 的 一 样 ， 如 果 不 一 样 就 显示 一 条 出 错 信息 
O 哲 时 跳 过 对 编码 函数 的 测试 


这 个 测试 文件 与 被 测试 的 源码 文件 位 于 同一 个 包 内 ， 它 唯一 导入 并 
使 用 的 包 为 testing &. KžtTestDecode 是 一 个 测试 用 例 ， 它 代表 的 
是 对 decode 函数 的 单元 测试 。TestDecode 接受 一 个 指向 testing.T 
结构 的 指针 作为 参数 ， 该 结构 是 testing 包 中 两 个 主要 结构 之 一 ， 当 被 


测试 函数 的 输出 结果 未 如 预期 时 ， 用 户 就 可 以 使 用 这 个 结构 来 产生 相应 
的 失败 Cfailure) 以 及 错误 Cerror) 。 


testing.T 结构 拥有 几 个 非常 有 用 的 函数 : 





e Log 一 一 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 与 fmt.Println 类 
似 ; 

。 Logf 一 一 根据 给 定 的 格式 ， 将 给 定 的 文本 记录 到 错误 日 志 里 面 ， 
与 fmt.Printf 类 似 ; 

e Fail 一 一 将 测试 函数 标记 为 “已 失败 ”， 但 允许 测试 函数 继续 执 
行 ; 

。 FailNow 一 一 将 测试 函数 标记 为 “已 失败 ?并 停止 执行 测试 函数 。 











除 以 上 4 个 函数 之 外 ， patel T 结构 还 提供 了 图 8-1 所 示 的 一 些 便 
利 函 数 〈convenience function) ， 这 些 便利 函数 都 是 由 以 上 4 个 函数 组 合 


而 成 的 。 
PO ES aN E 

















图 8-1 ”testing.T 结构 提供 的 各 个 函数 ， 每 个 格子 都 表示 一 个 函数 ， 其 中 位 于 白色 格子 内 的 函 
数 为 便利 函数 ， 它 们 由 位 于 灰色 格子 内 的 函数 组 合 而 成 。 例 如 ，Error 函数 是 Log 函数 和 Fail 
函数 的 组 合 函数 ， 它 在 被 调用 时 ， 会 先 调用 Log 函数 ， 然 后 再 调用 Fail 函数 























在 图 8-1 中 ， 组 合 函 数 Error 将 会 先后 调用 Log 函数 和 Fail 函数 ， 


而 组 合 函数 Fatal 则 会 先后 调用 Log 函数 和 FailNow 函数 。 


在 测试 函数 TestDecode 内 部 ， 程 序 会 正常 地 调用 decode 函数 ， 
然后 对 函数 返回 的 结果 进行 检查 。 如 果 函 数 返 回 的 结果 和 预期 的 结果 不 
一 致 ， 那 么 程序 就 可 以 根据 情况 调用 Fail 、FailNow , Error 
、Errorf 或 者 Fatalf 等 函数 。 正 如 之 前 所 说 ，Fail 函数 在 把 一 个 测 
试用 例 标记 为 “已 失败 ”之 后 ， 会 允许 这 个 测试 用 例 继续 执行 ， 

但 FailNow 函数 则 会 更 严格 一 些 一 一 它 在 把 一 个 测试 用 例 标记 为 “已 失 
败 ” 之 后 会 立即 退出 ， 不 再 执行 这 个 测试 用 例 的 剩余 代码 。 无 论 是 Fail 
还 是 FailNow ， 它 们 都 只 会 对 上 自己 所 处 的 测试 用 例 产 生 影响 ， 比 如 ， 在 
上 面 的 例子 中 ，TestDecode 调用 的 Error 函数 就 只 会 对 TestDecode 
AN PE BM 











为 了 运行 TestDecode 测试 用 例 ， 我 们 需要 在 测试 文件 
main_test.go 所 在 的 目录 中 执行 以 下 命令 : 


| 


这 条 命令 会 执行 当前 目录 中 名 字 以 _test .go 为 后 级 的 所 有 文件 。 
当 我 们 在 名 为 unit_testing 的 目录 中 执行 这 个 命令 时 ， 它 将 产生 以 下 
结果 : 


PASS 
ok unit_testing 0.0@4s 





可 惜 的 是 ， 这 个 结果 并 没有 给 出 多 少 有 用 的 信息 。 为 此 ， 我 们 可 以 











使 用 具体 〈verbose) 标志 -v KIRI ETEME E FP ah 8 hn a - 
cover ARIK AW US PIIRI EY i : 


go test -v -cover 


执行 这 条 命令 将 得 到 以 下 结果 : 


=== RUN TestDecode 
- PASS: TestDecode (0.00s) 

=== RUN TestEncode 
-- SKIP: TestEncode (0.00s) 
main_test.go:23: Skipping encoding for now 


PASS 
coverage: 46.7% of statements 
ok unit_testing 0.0@4s 





8.2.1 Btwn wl 


代码 清单 8-3 在 同一 个 测试 文件 里 包含 了 两 个 测试 用 例 ， 第 一 个 是 
前 面 已 经 介绍 过 的 TestDecode ， 而 另 一 个 则 是 TestEncode 。 因 为 代 
码 清单 8-1 中 的 程序 并 未 实现 相应 的 编码 方法 ， 所 以 TestEncode 并 没有 
做 任何 实际 的 行为 。 程 序 员 在 进行 测试 驱动 开发 (test-driven 
development, TDD) 的 时 候 ， 通 常会 让 测试 用 例 持续 地 失败 ， 直 到 函数 
被 真正 地 实现 出 来 为 止 ; 但 是 ， 为 了 避免 测试 用 例 在 函数 尚未 实现 之 前 
一 直 打 印 烦 人 的 失败 信息 ， 用 户 也 可 以 使 用 testing.T 结构 提供 的 
Skip 函数 ， 暂 时 跳 过 指定 的 测试 用 例 。 此 外 ， 如 果 某 个 测试 用 例 的 执 
行 时 间 非 常 长 ， 我 们 也 可 以 在 实施 完整 性 检查 (sanity check) 的 时 候 ， 
使 用 Skip 函数 跳 过 该 测试 用 例 。 


除了 可 以 直接 跳 过 整个 测试 用 例 ， 用 户 还 可 以 通过 向 go test 命令 
传 入 短暂 标志 -short ， 并 在 测试 用 例 中 使 用 茶 些 条 件 逻 辑 来 跳 过 测试 
中 的 指定 部 分 。 注 意 ， 这 种 做 法 跟 在 go test 命令 中 通过 选项 来 选择 性 
地 执行 指定 的 测试 不 一 样 : 选择 性 执行 只 会 执行 指定 的 测试 ， 并 跳 过 其 
他 所 有 测试 ， 而 -short 标志 则 会 根据 用 户 编写 测试 代码 的 方式 ， 跳 过 
测试 中 的 指定 部 分 或 者 跳 过 整个 测试 用 例 。 








作为 例子 ， 让 我 们 来 看 一 下 如 何 通 过 -short 标志 来 避免 执行 一 个 
长 时 间 运 行 的 测试 用 例 。 首 先 ， 在 main_test.go 文 件 中 导入 time 
包 ， 并 创建 一 个 新 的 测试 用 例 : 


func TestLongRunningTest(t *testing.T) { 
if testing.Short() { 
t.Skip("Skipping long-running test in short mode") 


time.Sleep(1@ * time.Second) 
} 





如 果 用 户 给 定 了 -short 标志 ， 测 试用 例 TestLongRunningTest 
将 被 跳 过 ; 相反， 如 采用 户 没 有 给 定 -short 标志 ， 那 
么 TestLongRunningTest 用 例 将 被 执行 ， 并 因此 导致 测试 过 程 休眠 10 
s。 现 在 ， 首 先 让 我 们 来 看 一 下 测试 用 例 在 一 般 情 况 下 是 如 何 运行 的 : 





=== RUN TestDecode 

--- PASS: TestDecode (0.00s) 

=== RUN TestEncode 

--- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 

=== RUN TestLongRunningTest 

--- PASS: TestLongRunningTest (10.0@s) 

PASS 

coverage: 46.7% of statements 


ok unit_testing 10.004s 


正如 我 们 所 料 ， 测 试 花 了 10 s 来 执行 TestLongRunningTest 测试 
用 例 。 现 在 ， 我 们 使 用 以 下 命令 再 次 运行 测试 : 


go test -v -cover -short 


这 次 运行 测试 将 得 出 以 下 结果 : 


=== RUN TestDecode 

--- PASS: TestDecode (0.00s) 

=== RUN TestEncode 

--- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 

=== RUN TestLongRunningTest 

--- SKIP: TestLongRunningTest (0.00s) 


main_test.go:29: Skipping long-running test in short mode 
PASS 
coverage: 46.7% of statements 
ok unit_testing 0.004s 





正如 结果 所 示 ， 长 时 间 运 行 的 测试 用 例 TestLongRunningTest 在 
这 次 测试 中 被 跳 过 了 。 
8.2.2 ”以 并 行 方 式 运 行 测 试 

正如 之 前 所 说 ， 单 元 测试 的 目的 是 独立 地 进行 测试 。 尽 管 有 些 时 
候 ， 测 试 套件 会 因为 内 部 存在 依赖 关系 而 无 法 独立 地 进行 单元 测试 ， 但 


是 只 要 单元 测试 可 以 独立 地 进行 ， 用 户 就 可 以 通过 并 行 地 运行 测试 用 例 
来 提升 测试 的 速度 了 ， 本 市 的 内 容 将 癌 我 们 展示 如 何在 Go 中 实现 这 


首先 ， 在 main_test.go 文 件 所 在 的 目录 中 创建 一 个 名 
为 parallel_test.go 的 文件 ， 并 在 文件 中 键入 代码 清单 8-4 所 示 的 代 
Ay. 














代码 清单 8-4 ”并 行 测试 














package main 


import ( 
"testing" 
"time" 


) 


func TestParallel_1(t *testing.T) { @ 
t.Parallel() @ 
time.Sleep(1 * time.Second) 


} 


func TestParallel 2(t *testing.T) { © 
t.Parallel() 
time.Sleep(2 * time.Second) 


} 


func TestParallel 3(t *testing.T) { @ 
t.Parallel() 
time.Sleep(3 * time.Second) 


} 





@ 模拟 需要 耗 时 一 秒 钟 运行 的 任务 
© 调用 Parallel 函数 ， 以 并 行 方式 运行 测试 用 例 
O 模拟 需要 耗 时 2 秒 运 行 的 任务 


O 模拟 需要 耗 时 3 秒 运行 的 任务 


这 个 程序 利用 time.Sleep 函数 ， 以 3 个 测试 用 例 分 别 模拟 了 3 个 需 
要 耗 时 1s、2s 和 3s 来 运行 的 任务 ， 并 且 为 了 让 这 些 测试 用 例 能 够 以 并 行 
的 方式 运行 ， 程 序 还 在 每 个 测试 用 例 的 开头 调用 了 testing.T 结构 的 
Parallel 函数 。 





现在 ,我们 只 要 在 终端 中 执行 以 下 命令 ，Go 束 会 以 并 行 的 方式 运 
行 测 试 : 





go test -v -short -parallel 3 


这 条 命令 中 的 并 行 标 志 -parallel 用 于 指示 Go 以 并 行 方式 运行 测 
试用 例 ， 而 参数 3 则 表示 我 们 希望 最 多 并 行 运行 3 个 测试 用 例 。 另 外 ， 
这 条 命令 还 使 用 了 -short 标志 ， 以 便 跳 过 main_test.go 测试 文件 中 
需要 长 时 间 运 行 的 测试 用 例 。 以 下 是 这 个 命令 的 执行 结果 : 








= RUN TestDecode 
- PASS: TestDecode (0.00s) 
= RUN TestEncode 
--- SKIP: TestEncode (0.00s) 
main_test.go:24: Skipping encoding for now 
=== RUN TestLongRunningTest 
--- SKIP: TestLongRunningTest (0.00s) 
main_test.go:30@: Skipping long-running test in short mode 
RUN TestParallel 1 
RUN TestParallel 2 
RUN TestParallel 3 
PASS: TestParallel 1 (1.00s) 
- PASS: TestParallel 2 (2.00s) 
PASS: TestParallel 3 (3.00s) 


unit_testing 3.0@6s 





从 这 个 结果 我 们 可 以 看 到 ，main_test.go 文 件 和 
parallel_test .go 文件 中 的 所 有 测试 用 例 都 被 执行 了 ， 更 为 重要 的 
是 ，parallel_test.go 文 件 中 的 3 个 并 行 测试 用 例 被 同时 执行 了 : JS 
管 这 3 个 并 行 测 试用 例 的 运行 时 长 各 有 不 同 ， 但 由 于 它们 是 同时 运行 
的 ， 所 以 这 3 个 测试 用 例 最 终 都 在 运行 时 长 最 长 的 测试 用 例 
TestParallel_3 的 执行 过 程 中 结束 了 ， 这 也 是 整个 测试 最 终 耗 绩 了 
3.006 s 的 原因 一 一 其 中 0.006 s 用 于 执行 main_test.go 中 的 前 几 个 测试 
用 例 ， 而 3 s 则 用 于 执行 parallel_test.go 中 运行 时 间 最 长 的 测试 用 例 
TestParallel 3. 








8.2.3 ”基准 测试 


Go 的 testing 包 文 持 两 种 类 型 的 测试 ， 一 种 是 用 于 检验 程序 功能 
性 的 功能 测试 (functional testing) ， 而 另 一 种 则 是 用 于 碍 明 任务 单元 性 
HEA EME WM i (benchmarking) 。 在 上 一 节 学 习 过 如 何 进 行 功能 测试 之 
后 ， 这 一 节 我 们 将 要 学 习 如 何 进 行 基准 测试 。 





跟 单 元 测试 一 样 ， 基 准 测 试用 例 也 需要 放置 到 以 _test .go 为 后 绥 
的 文件 中 ， 并 且 每 个 基准 测试 函数 都 需要 符合 以 下 格式 : 


func BenchmarkXxx(*testing.B) { ... } 


作为 例子 ， 代 码 清 单 8-5 展示 了 一 个 基准 测试 用 例 函 数 ， 这 个 函数 
定义 在 文件 pench_test.go 里 面 。 








代码 清单 8-5 “基准 测试 








package main 
import ( 
"testing" 


) 


// benchmarking the decode function 


func BenchmarkDecode(b *testing.B) { 
for i := @; i < b.N; i++ { @ 
decode("post.json") 
} 
} 





@ 循环 执行 解码 函数 ， 以 便 对 其 进行 b.N 次 基准 测试 


正如 代码 所 示 ， 在 Go 语言 中 进行 基准 测试 是 非常 直 观 的 :测试 程 
序 要 做 的 束 是 将 被 测试 的 代码 执行 b.N 次 ， 以 便 准确 地 检测 出 代码 的 啊 
应 时 间 ， 其 中 b.N 的 值 将 根据 被 执行 的 代码 而 改变 。 比 如 ， 在 上 面 展示 
的 基准 测试 例子 中 ， 测 试 程序 束 将 decode 函数 执行 了 b.N 次 。 


为 了 运行 基准 测 斌 用例， 用户 需 要 在 执行 go test 命令 时 使 用 基准 
测试 标志 -bench ， 并 将 一 个 正则 表达 式 用 作 该 标志 的 参数 ， 从 而 标识 
出 自己 想 要 运行 的 基准 训 试 文件 。 当 我 们 需要 运行 目录 下 的 所 有 基准 测 
试 文件 时 ， 只 需要 把 点 〈.) 用 作 -bench 标志 的 参数 即 可 : 


go test -v -cover -Short -bench . 


下 面 是 这 条 命令 的 执行 结果 : 














=== RUN TestDecode 
- PASS: TestDecode (0.00s) 
=== RUN TestEncode 


--- SKIP: TestEncode (0.00s) 

main_test.go:38: Skipping encoding for now 

=== RUN TestLongRunningTest 

--- SKIP: TestLongRunningTest (0.00s) 

main_test.go:44: Skipping long-running test in short mode 
PASS 

BenchmarkDecode 100000 19480 ns/op 

coverage: 42.4% of statements 

ok unit_testing 2.243s 





结果 中 的 166666 为 测试 时 b.N 的 实际 值 ， 也 就 是 函数 被 循环 执行 
的 次 数 。 在 这 个 例子 中 ， 连 代 进 行 了 10 万 次 ， 并 且 每 次 耗费 了 19480 
ns， 即 0.01948 ms。 需 要 注意 的 是 ， 在 进行 基 ; 准 测试 时 ， 测 试用 例 的 迭 
代 次 数 是 由 Go 自行 决定 的 ， 虽 然 用 户 可 以 通过 限制 基准 测试 的 运行 时 


间 达 到 限制 ; 
试 程序 将 进行 足够 多 次 的 迭代 ， 直 到 获得 一 个 准确 的 测量 值 为 止 。 在 
Go 1.5 中 ，test 子 命令 拥有 一 个 -test.count 标志 ， 它 可 以 让 用 户 指 
定 每 个 测试 以 及 基准 测试 的 运行 次 数 ， 该 标志 的 默认 值 为 1。 





测 


注意 ， 上 面 的 命令 既 运 行 了 基准 测试 ， 也 运行 了 功能 测试 。 如 果 需 
要 ， 用 户 也 可 以 通过 运行 标志 -run 来 忽略 功能 测试 。-run 标志 用 于 指 
定 需要 被 执行 的 功能 测试 用 例 ， 如 果 用 户 把 一 个 不 存在 的 功能 测试 名 字 
用 作 -run 标志 的 参数 ， 那 么 所 有 功能 测试 都 将 被 忽略 。 比 如 ， 如 果 我 
们 执行 以 下 命令 : 


go test -run x -bench . 


那么 由 于 我 们 的 测试 中 不 存在 任何 名 字 为 x 的 功能 测试 用 例 ， 因 此 





PIA TARE WU EBA 22 BUST © ERMITEA Ta F go test ar 
SRT EU FAR: 


PASS 
BenchmarkDecode 100000 19714 ns/op 


ok unit_testing 2.15@s 





虽然 检测 单个 函数 的 运行 速度 非常 有 用 ， 但 如 末 我 们 能 够 对 比 两 个 
函数 的 运行 速度 ， 那 么 事情 无 疑 会 变 得 更 加 有 意义 ! 回想 一 下 ， 我 们 在 
第 7 章 曾 经 学 过 如 何 用 两 种 不 同 的 方法 把 JSON 数 据 解 封 为 结构 : 一 种 是 
使 用 Decode 函数 ， 另 一 种 则 是 使 用 Unmarshal 函数 。 因 为 上 面 的 基准 
测试 已 经 检测 出 了 Decode 函数 的 运行 速度 ， 那 么 接 下 来 就 让 我 们 检测 
一 下 Unmarshal 函数 的 运行 速度 吧 。 但 是 在 进行 基准 测试 之 前 ， 我 们 需 
要 像 代 码 清 单 8-6 展 示 的 那样 ， 将 解 封 操作 的 代码 重 构 到 main.go 文 件 
的 unmarshal 函数 中 。 











代码 清单 8-6” 解 封 JSON 数 据 的 函数 








func unmarshal(filename string) (post Post, err error) { 


jsonFile, err := os.Open(filename) 

if err != nil { 
fmt.Printin("Error opening JSON file:", err) 
return 

} 


defer jsonFile.Close() 


jsonData, err := ioutil.ReadAll(jsonFile) 

if err != nil { 
fmt.Println("Error reading JSON data:", err) 
return 

} 

json.Unmarshal(jsonData, &post) 

return 


} 


[L CR 


之 后 ， 我 们 还 需要 在 基准 测试 文件 bench_test. go 中 添加 代码 清 
单 8-7 所 示 的 基准 测试 用 例 ， 以 便 对 unmarshal 函 数 进 行 基准 测试 。 








代码 清单 8-7“” 对 unmarshal 函 数 进 行 基准 测试 

















func BenchmarkUnmarshal(b *testing.B) { 
for i := 0; i < b.N; i++ { 
unmarshal("post. json") 


} 
} 





一 切 准 备 就 绪 之 后 ， 再 次 运行 基准 测试 命令 ， 我 们 将 得 到 以 下 结 
果 : 
PASS 


BenchmarkDecode 100000 19577 ns/op 
BenchmarkUnmarshal 50000 24532 ns/op 


ok unit_testing 3.628s 





从 上 述 结果 可 以 看 到 ，Decode ee J 需要 耗费 0.019577 
ms， 而 Unmarshal 函数 每 次 执行 需要 耗费 0.024532 ms， 这 说 
明 Unmarshal 函数 比 Decode & 了 大 约 25%。 


8.3 ”使 用 Go 进行 HTTP 测 试 





因为 这 是 一 本 关于 Web 编 程 的 书 ， 所 以 我 们 除了 要 学 习 如 何 测 试 普 
通 的 Go 程序 ， 还 需要 学 习 如 何 测 试 Go Web 应 用 。 测 试 Go Web 应 用 的 方 
法 有 很 多 ， 但 是 在 这 一 节 中 ， 我 们 只 考虑 如 何 使 用 Go 对 Web 应 用 的 处 理 
需 进 行 单元 测试 。 











对 Go Web 应 用 的 单元 测试 可 以 通过 testing/httptest 包 来 完 
成 。 这 个 包 提 供 了 模拟 一 个 Web 服 务 器 所 需 的 设施 ， 用 户 可 以 利 
用 net/http 包 中 的 客户 端 函 数 癌 这 个 服务 器 发 送 HTTP 请 求 ， 然 后 获取 
模拟 服务 器 返回 的 HTTP 啊 应 。 


为 了 演示 httptest 包 的 使 用 方法 ， 我 们 会 复 用 之 前 在 7.14 节 展示 
过 的 简单 Web 服 务 。 正 如 之 前 所 说 ， 这 个 简单 Web 服 务 只 拥有 一 个 名 
为 handleRequest 的 处 理 器 ， 它 会 根据 请 求 使 用 的 HTTP 方 法 ， 将 请 求 
多 路 复 用 到 相应 的 处 理 器 函数 。 举 个 例子 ， 如 有 果 handleRequest 接收 
到 的 是 一 个 HTTP GET 请 求 ， 那 么 它 会 把 该 请 求 多 路 复 用 到 handleGet 
函数 ， 代 码 清 单 8-8 展 示 了 这 两 个 函数 的 具体 定义 。 






























































代码 清单 8-8 负责 多 路 复 用 请 求 的 处 理 器 以 及 负责 处 理 请 求 的 GET 处 理 器 函数 


























func handleRequest(w http.ResponseWriter, r *http.Request) { ©® 
var err error 
switch r.Method { @ 
case "GET": 
err = handleGet(w, r) 
case "POST": 
err = handlePost(w, r) 
case "PUT": 
err = handlePut(w, r) 


case "DELETE": 
err = handleDelete(w, r) 


if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError ) 
return 

} 


} 


func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 





@ handleRequest 将 根据 请 求 使 用 的 HITP 方法 对 其 进行 多 路 复 用 


O 根据 请 求 使 用 的 HTTP 方法 ， 调 用 相应 的 处 理 器 函数 


代码 清单 8-9 展 示 了 一 个 通过 HTTP GET 请 求 对 简单 Web 服 务 进 行 单 
元 测试 的 例子 ， 而 图 8-2 则 展示 了 这 个 程序 的 整个 执行 过 程 。 








代码 清单 8-9 ”使 用 GET 请 求 进行 测试 








package main 


import ( 
"encoding/json" 


"net/http" 
"net/http/httptest" 
"testing" 

) 


func TestHandleGet(t *testing.T) { 
mux := http.NewServeMux() @ 
mux.HandleFunc("/post/", handleRequest) @ 


writer := httptest.NewRecorder() © 
request, _ := http.NewRequest("GET", "/post/1", nil) @ 
mux.ServeHTTP(writer, request) © 


if writer.Code != 200 { © 
t.Errorf("Response code is %v", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
t.Error( "Cannot retrieve JSON post") 
} 
} 





O 创建 一 个 用 于 运行 测试 的 多 路 复 用 器 


O 绑 定 想 要 测试 的 处 理 需 

O 创建 记录 器 ， 用 于 获取 服务 器 返回 的 HTTP 啊 应 
O 为 被 测试 的 处 理 器 创建 相应 的 请 求 

© 问 被 测试 的 处 理 器 发 送 请 求 


O 对 记录 器 记载 的 响应 结果 进行 检查 








因为 每 个 测试 用 例 都 会 独立 运行 并 启动 各 自 独 有 的 用 于 测试 的 Web 
服务 器 ， 所 以 程序 需要 创建 一 个 多 路 复 用 器 并 将 handleRequest 处 理 


器 与 其 进行 绑 定 。 除 此 之 外 ， 为 了 获取 服务 器 返回 的 HITP 响 应 ， 程 序 
使 用 httptest.New Recorder 函 数 创建 了 一 个 ResponseRecorder 结 
构 ， 这 个 结构 可 以 把 响应 存储 起 来 以 便 进 行 后 续 的 检查 。 





与 此 同时 ， 程 序 还 需要 调用 http .NewRequest 函数 ， 并 将 请 求 使 
用 的 HITP 方 法 、 被 请 求 的 URL 以 及 可 选 的 HTTP 请求 主体 传递 给 该 函 
数 ， 从 而 创建 一 个 HITP 请 求 〈 在 第 3 章 和 第 4 章 ， 我 们 讨论 的 是 如 何 分 
析 一 个 HTTP 请求， 而 创建 HITP 请 求 正 好 就 是 分 析 HITP 请 求 的 逆 操 
HE) o 





创建 多 路 复 用 器 


将 被 测试 的 处 理 器 与 多 路 复 用 器 进行 绑 定 


创建 记录 器 


创建 请 求 


向 被 测试 的 处 理 器 发 送 请 求 ， 从 而 引发 对 记录 器 的 写 入 操作 


对 记录 器 记载 的 响应 结果 进行 检查 








图 8-2 ”使 用 Go 的 httptest 包 进 行 HITTP 测 试 的 具体 步骤 





程序 在 创建 出 相应 的 记录 器 以 及 HTTP 请 求 之 后 ， 就 会 使 
用 ServeHTTP 把 它们 传递 给 多 路 复 用 器 。 多 路 复 用 器 handleRequest 
在 接收 到 请 求 之 后 ， 就 会 把 请 求 转发 给 handleGet 函数 ， 然 后 
由 handleGet 函数 对 请 求 进行 处 理 ， 并 最 终 返 回 一 个 HTTP 响 应 。 跟 一 
般 服 务 器 不 同 的 是 ， 模 拟 服务 器 的 多 路 复 用 器 不 会 把 处 理 器 返回 的 响应 
发 送 至 浏览 器 ， 而 是 会 把 响应 推 入 响应 记录 器 里 面 ， 从 而 使 测试 程序 可 
以 在 之 后 对 响应 的 结果 进行 验证 。 测 试 程序 最 后 的 几 行 代码 非常 容易 看 
懂 ， 它 们 要 做 的 就 是 对 响应 进行 检查 ， 看 看 处 理 器 返回 的 结果 是 否 跟 预 
期 的 一 样 ， 并 在 出 现 意料 之 外 的 结果 时 ， 像 普通 的 单元 测试 那样 抛 出 一 


个 错误 。 











因为 这 些 操作 看 上 去 都 非常 简单 ， 所 以 不 妨 让 我 们 再 来 看 男 一 个 例 
子 一 一 代码 清单 8-10 展 示 了 如 何 为 PUT 请 求 创建 一 个 测试 用 例 。 














代码 清单 8-10 “对 PUT 请 求 进行 测试 














func TestHandlePut(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest ) 


writer := httptest.NewRecorder() 

json := strings.NewReader( {"content": "Updated post", "author": "Sau 
Sheong"} ) 

request, _ := http.NewRequest("PUT", "/post/1", json) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 
} 





正如 代码 所 示 ， 这 次 的 测试 用 例 除了 需要 问 请 求 传 入 JSON 数 据 ， 
跟 之 前 展示 的 测试 用 例 并 没有 什么 特别 大 的 不 同 。 除 此 之 外 你 可 能 会 注 
意 到 ， 上 述 两 个 测试 用 例 出 现 了 一 些 完全 相同 的 代码 。 为 了 保持 代码 的 
简洁 性 ， 我 们 可 以 把 一 些 重复 出 现 的 测试 代码 以 及 其 他 测试 夹具 
(fixture 〉 代 码 放 置 到 一 个 预 设 函 数 (setup function) 里 面 ， 然 后 在 运 
行 测试 之 前 执行 这 个 函数 。 


Go 的 testing 包 人 允许 用 户 通 过 TestMain 函数 ， 在 进行 测试 时 执行 
相应 的 预 设 〈setup) 操作 或 者 拆 和 外 (teardown) 操作 。 一 个 典型 的 
TestMain 函数 看 上 去 是 下 面 这 个 样子 的 : 
func TestMain(m *testing.M) { 

setUp() 


code := m.Run() 
tearDown() 


os.Exit(code) 


} 





setUp 函数 和 tearDown AŽ HE MS MAE FAT ERA PREY 
阶段 需要 执行 的 工作 。 需 要 注意 的 是 ，setUp 函数 和 tearDown 函数 是 
为 所 有 测试 用 例 设置 的 ， 它 们 在 整个 测试 过 程 中 只 会 被 执行 一 次 ， 其 中 
setUp 函数 会 在 所 有 测试 用 例 被 执行 之 前 执行 ， 而 tearDown 函数 则 会 
在 所 有 测试 用 例 都 被 执行 完毕 之 后 执行 。 至 于 测试 程序 中 的 各 个 测试 用 
例 ， 则 由 testing.M 结构 的 Run 方法 负责 调用 ， 该 方法 在 执行 之 后 将 返 
回 一 个 退出 码 (exit code) ， 用 户 可 以 把 这 个 退出 码 传递 给 os.Exit K 
数 。 








代码 清单 8-11 展 示 了 测试 程序 使 用 TestMain 函数 之 后 的 样子 。 


代码 清单 8-11 使 用 httptest 包 的 TestMain MA 











package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"os" 

"strings" 

"testing" 


) 


var mux *http.ServeMux 
var writer *httptest.ResponseRecorder 


func TestMain(m *testing.M) { 
setUp() 
code := m.Run() 
os.Exit(code) 


} 


func setUp() { 
mux = http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest ) 
writer = httptest.NewRecorder() 


} 


func TestHandleGet(t *testing.T) { 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
t.Errorf("Cannot retrieve JSON post") 
} 
} 


func TestHandlePut(t *testing.T) { 
json := strings .NewReader(`{"content":"Updated post","author":"Sau 
Sheong"}> ) 
request, _ := http.NewRequest("PUT", "/post/1", json) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 





更 新 后 的 测试 程序 把 每 个 测试 用 例 都 会 用 到 的 全 局 变量 放 到 了 
setUp 函数 中 ， 这 一 修改 不 仅 让 测试 用 例 函 数 变 得 更 加 紧 竣 ， 而 且 还 把 
所 有 与 测试 用 例 有 关 的 预 设 操作 都 集中 a 到 了 一 起 。 但 是 ， 因 为 这 个 程序 





在 测试 之 后 不 需要 进行 任何 收尾 工作 ， 所 以 它 没有 配置 相应 的 拆 凶 函 
数 ， 当 所 有 测试 用 例 部 运行 完毕 之 后 ， 测 试 程序 就 会 直接 退出 。 


上 面 展示 的 代码 只 测试 了 了 Web 服务 的 多 路 复 用 器 以 及 处 理 器 ， 但 它 
并 没有 测试 web 服务 的 另 一 个 重要 部 分 。 你 也 许 还 记得 ， 在 本 书 的 第 7 
章 中 ， 我 们 曾经 从 Web 服 务 中 抽 离 出 了 数据 层 ， 并 将 所 有 数据 操作 代码 
都 放置 到 了 data. go 文件 中 。 因 为 测试 handleGet 函数 需要 调用 Post 

结构 的 retrieve 函数 ， 而 测试 handlepPut 函数 则 需要 调用 Post 结构 
的 retrieve 函数 以 及 update 函数 ， 所 以 上 述 测试 程序 在 对 简单 Web 服 
务 进行 单元 测试 时 ， 实 际 上 是 在 对 数据 库 中 的 数据 执行 获取 操作 以 及 修 
改 操 作 。 











因为 被 测试 的 操作 涉及 依赖 关系， 所 以 上 述 单元 测试 实际 上 并 不 是 
独立 进行 的 ， 为 了 解决 这 个 问题 ， 我 们 需要 用 到 下 一 市 介绍 的 技术 。 


8.4 测试 蔡 身 以 及 依赖 注入 


WA (test double) 是 一 种 能 够 让 单元 测试 用 例 变 得 更 为 独立 
的 利用 方法 。 当 测试 不 方便 使 用 实际 的 对 象 、 结 构 或 者 函数 时 ， 我 们 融 
可 以 使 用 测试 其 号 来 模拟 它们 。 因 为 测试 蔡 吴 能 够 提高 被 测试 代码 的 独 
六 性 ， 所 以 自动 单元 测试 环境 经 常会 使 用 这 种 技术 。 


测试 邮件 发 送 代 码 是 一 个 需要 使 用 测试 蔡 喘 的 场景 : 很 自然 地 ， 你 
并 不 希望 在 进行 单元 测试 时 发 送 真 正 的 邮件 ， 而 解决 这 个 问题 的 一 种 方 
法 ， 就 是 创建 出 能 够 模拟 邮件 及 送 操作 的 测试 蔡 喘 。 同 样 地 ， 为 了 对 简 
单 Web 服 务 进行 单元 测试 ， 我 们 需要 创建 出 一 些 测 试 荃 员 ， 并 通过 这 些 
蔡 吴 移 除 单元 测试 用 例 对 真实 数据 库 的 依赖 。 


测试 符号 的 概念 非常 直观 易 懂 一 一 程序 员 要 做 的 就 是 在 进行 目 动 测 
试 时 ， 创 建 出 测试 殖 吴 并 使 用 它们 去 代 瞪 实际 的 函数 或 者 结构 。 然 而 问 
题 在 于 ， 使 用 测试 蔡 身 需要 在 编码 之 前 进行 相应 的 设计 : 如 果 你 在 设计 
程序 时 根本 没有 考 碟 过 使 用 测试 苦 身 ， 那 么 你 很 可 能 无 法 在 实际 测试 中 
使 用 这 一 技术 。 比 如 ， 上 一 市 展示 的 简单 Web 服 务 的 设计 束 无 法 在 测试 
中 创建 测试 谷 身 ， 这 是 因为 对 数据 库 的 依赖 已 经 深 深 地 扎根 于 这 些 代 码 
a 














实现 测试 蔡 身 的 一 种 设计 方法 是 使 用 依赖 注入 (dependency 
injection) 设计 模式 。 这 种 模式 通过 回 被 调用 的 对 象 、 结 构 或 者 函数 传 
入 依赖 关系 ， 然 后 由 依赖 关系 代 葵 被 调用 者 执行 实际 的 操作 ， 以 此 来 
解 耦 软件 中 的 两 个 或 多 个 层 〈layer) ， 而 在 Go 语言 当中 ， 被 传 入 的 依 


赖 天 系 通 常会 是 一 种 接口 类 型 。 接 下 来 ， 就 让 我 们 来 看 看 ， 如 何在 第 7 
革 介 绍 的 简单 Web 服 务 中 使 用 依赖 注入 设计 模式 。 


使 用 Go 实现 依赖 注入 


在 第 7 章 介 绍 的 简单 Web 服 务 中 ，hand1leRequest 处 理 器 函数 会 
将 GET 请 求 转发 给 handleGet 函数 ， 后 者 会 从 URL 中 提取 文章 的 ID， 然 
后 通过 data.go 文 件 中 的 retrieve 函数 获取 与 文章 ID 相对 应 的 Post 
结构 。 当 retrieve 函数 被 调用 时 ， 它 会 使 用 全 局 的 sq1.DB 结构 去 打开 
一 个 连接 至 PostgreSQL 的 数据 库 连 接 ， 并 在 posts 表 中 查找 指定 的 数 
据 。 











图 8-3 展 示 了 简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 。 
除 retrieve 函数 需要 通过 全 局 的 sql .DB 实例 访问 数据 库 之 外 ， 访 问 数 
据 库 对 于 其 他 函数 来 说 都 是 透明 的 〈transparent) 。 


由 main 邱 数 调用 
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图 8-3 ”简单 Web 服 务 在 处 理 GET 请 求 时 的 函数 调用 流程 图 




















正如 图 8-3 所 示 ，handleRequest 和 handleGet 都 依赖 于 
retrieve 函数 ， 而 后 者 最 终 又 依赖 于 sql.DB 。 因 为 对 sql1.DB 的 依赖 
是 整个 问题 的 根源 ， 所 以 我 们 必须 将 其 移 除 。 





跟 很 多 问题 一 样 ， 解 耦 依赖 关系 也 存在 着 好 几 种 不 同 的 方式 ; 既 可 
以 从 底部 开始 ， 对 数据 抽象 层 的 依赖 关系 进行 解 厢 ， 人 然后 直接 获取 
sql.DB 结构 ， 也 可 以 从 顶部 开始 ， 将 sq1.DB 注入 到 handleRequest 
当中 。 本 节 要 介绍 的 是 后 一 种 方法 ， 也 就 是 以 自 顶 向 下 的 方式 解 耦 依赖 
天 系 的 方法 。 








图 8-4 展 示 了 移 除 对 sq1 .DB 的 依赖 并 将 这 种 依赖 通过 主 程序 注入 函 
数 调用 流程 中 的 具体 方法 。 注 意 ， 问 题 的 关键 并 不 是 避免 使 用 sq1.DB 


， 而 是 避免 对 它 的 直接 依赖 ， 这 样 我 们 才能 够 在 测试 时 使 用 测试 蔡 身 。 
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图 8-4 将 一 个 包含 sq1.DB 的 Post 结构 传递 到 函数 调用 流程 中 ， 以 此 来 对 简单 Web 服 务实 现 依 
赖 注 入 模式 。 因 为 Post 结构 已 经 包含 了 sql.DB ， 所 以 调用 流程 中 的 所 有 函数 都 不 再 依 
赖 sq1 .DB 


正如 前 面 所 说 ， 为 了 解 灶 被 调用 函数 对 sq1.DB 的 依赖 ， 我 们 可 以 


将 sql.DB 注入 handleRequest ， 但 是 把 sq1.DB Seiler Fs sql .DB 
的 指针 作为 参数 传递 给 handleRequest 对 解决 问题 是 没有 任何 帮助 
的 ， 因 为 这 样 做 只 不 过 是 将 问题 推 给 了 控制 流 的 上 游 。 作 为 奉 代 ， 我 们 
需要 将 代码 清单 8-12 所 示 的 Text 接口 传递 给 handleRequest 。 当 测试 
程序 需要 从 数据 库 里 面 获取 一 篇 文章 时 ， 它 可 以 调用 Text 接口 的 方 
法 ， 并 假设 这 个 方法 知道 自己 应 该 做 什么 以 及 应 该 返回 什么 数据 。 








代码 清单 8-12 ”传递 给 handleRequest 的 接口 





type Text interface { 
fetch(id int) (err error) 
create() (err error) 
update() (err error) 


delete() (err error) 





接 下 来 ， 我 们 要 做 的 就 是 让 Post 结构 实现 Text 接口 ， 并 将 它 的 一 
个 字段 设置 成 一 个 指向 sql.DB 的 指针 。 为 了 让 Post 结构 实现 Text 接 
口 ， 我 们 需要 让 Post 结构 实现 Text 接口 拥有 的 所 有 方法 ， 不 过 由 于 代 
人 码 清单 8-12 中 定义 的 Text 接口 原本 就 是 根据 Post 结构 拥有 的 方法 定义 
而 来 的 ， 所 以 Post 结构 实际 上 已 经 实现 了 Text 接口 。 代 码 清单 8-13 展 
示 了 添加 新 字段 之 后 的 Post 结构 。 


























代码 清单 8-13 ”添加 了 新 字段 之 后 的 Post 结构 




















type Post struct { 
Db *sql.DB 
Id int json:" id” 
Content string `json:"content"` 
Author string ~json: "author" 


} 


[L E 


这 种 做 法 解决 了 将 sql.DB 直接 传递 给 handleRequest 的 问题 : FE 
序 并 不 需要 将 sql.DB 传递 给 被 调用 的 函数 ， 它 只 需要 和 之 前 一 样 ， 向 
被 调用 的 函数 传递 Post 结构 的 实例 即 可 ， 而 Post 结构 的 各 个 方法 也 会 
使 用 结构 内 部 的 sql1.DB 指针 来 代 茶 原本 对 全 局 变量 的 访问 。 因 
为 handleRequest 函数 还 是 和 以 前 一 样 ， 接 受 Post 结构 作为 参数 ， 所 
以 它 的 签名 不 需要 做 任何 修改 。 在 根据 新 的 Post 结构 做 相应 的 修改 之 
后 ，handleRequest 函数 如 代码 清单 8-14 所 示 。 








代码 清单 8-14 ”修改 后 的 handleRequest 函数 





func handleRequest(t Text) http.HandlerFunc { @ 
return func(w http.ResponsewWriter, r *http.Request) { @ 
var err error 
switch r.Method { 
case "GET": 
err = handleGet(w, r, t) © 
case "POST": 
err = handlePost(w, r, t) 
case "PUT": 
err = handlePut(w, r, t) 
case "DELETE": 
err = handleDelete(w, r, t) 
} 
if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 


} 





@ A Text 接口 


人 @ 返回 带 有 正确 签名 的 函数 


O 将 Text 接 口传 递 给 实际 的 处 理 需 





正如 代码 所 示 ， 因 为 handleRequest 函数 已 经 不 再 遵循 
ServeHTTP 方法 的 签名 规则 ， 所 以 它 已 经 不 再 是 一 个 处 理 器 函数 了 。 这 
使 我 们 无 法 再 使 用 HandleFunc 函数 把 它 与 一 个 URL 绑 定 在 一 起 了 。 


为 了 解决 这 个 问题 ， 程 序 再 次 使 用 了 本 书 第 3 章 中 介绍 过 的 处 理 器 
串联 技术 ， 让 handleRequest 返回 了 一 个 http.HandlerFunc 函数 。 


之 后 ， 程 序 在 main 函数 里 面 将 不 再 绑 定 handleRequest 函数 到 
URL， 而 是 直接 调用 handleRequest 函数 ， 让 它 返 回 一 
个 http.HandleFunc 函数 。 因 为 被 返回 的 函数 符合 HandleFunc 方法 
的 签名 要 求 ， 所 以 程序 就 可 以 像 之 前 一 样 ， 把 它 用 作 处 理 霹 并 与 指定 的 
URL 进 行 绑 定 。 代 码 清单 8-15 展 示 了 修改 后 的 main 函数 。 














代码 清单 8-15 “修改 后 的 main 函数 














func main() { 


var err error 
db, err := sql.Open("postgres", "user=gwp dbname=gwp password=gwp sslmod 
e= 
disable") 
if err != nil { 
panic(err) 


server := http.Server{ 
Addr: ":8080", 


} 
http.HandleFunc("/post/", handleRequest(&Post{Db: db})) @ 
server.ListenAndServe() 


} 





@ 将 Post 结构 传递 给 handleRequest 函 数 ， 然 后 绑 定 函 数 返 回 的 处 理 
器 


注意 ， 程 序 通过 Post 结构 ， 以 间接 的 方式 将 指向 sq1.DB 的 指针 传 
递 给 了 handleRequest 函数 ， 这 就 是 将 依赖 天 系 注 入 handleRequest 
的 方法 。 代 码 清单 8-16 展 示 了 同样 的 依赖 关系 是 如 何 被 注入 handleGet 
函数 的 。 





代码 清单 8-16 ”修改 后 的 handleGet 函数 

















func handleGet(w http.Responsewriter, r *http.Request, post Text) (err err 
or) {@ 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 
} 
err = post.fetch(id) @ 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(post, "", "\t\t") 
if err != nil { 
return 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 





@ 接受 Text 接口 作为 参数 
O 获取 数据 并 将 其 存储 到 Post 结构 


修改 后 的 handleGet 函数 跟 之 前 差不多 ， 主 要 区 别 在 于 现在 的 
handleGet 函数 将 直接 接受 Post 结构 ， 而 不 是 像 以 前 那样 在 内 部 创建 








Post 结构 。 除 此 之 外 ，handleGet 函数 现在 会 通过 调用 Post 结构 的 
fetch 方法 来 获取 数据 ， 而 不 必 再 调用 需要 访问 全 局 sql .DB 实例 的 
retrieve 函数 。 代 码 清单 8-17 展 示 了 Post 结构 的 fetch 方法 的 具体 定 








义 。 











代码 清 

















func (post *Post) fetch(id int) (err error) { 
err = post.Db.QueryRow("select id, content, author from posts where id = 
m1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 


} 


8-17 





新 的 fetch 方法 








这 个 fetch 方法 在 访问 数据 库 时 不 需要 使 用 全 局 的 sq1.DB 结构 ， 
而 是 使 用 被 传 入 的 Post 结构 的 Db 字段 来 访问 数据 库 。 如 果 我 们 现在 编 
译 并 运行 修改 后 的 简单 Web 服 务 ， 那 么 它 将 和 修改 之 前 的 简单 Web 服 务 
一 样 正 常 工作。 不 同 的 地 方 在 于 ， 修 改 后 的 代码 已 经 移 除 了 对 全 局 的 





sql.DB 结构 的 依赖 。 


只 要 对 数据 库 的 依赖 还 深 埋 在 代码 之 中 ， 我 们 就 无 法 对 其 进行 独立 
的 测试 。 为 此 ， 我 们 在 上 面 花 了 不 少 功夫 来 移 除 代码 中 的 依赖 ， 从 而 使 
单元 测试 用 例 可 以 变 得 更 为 独立 。 在 通过 外 部 代码 实现 依赖 注入 之 后 ， 








我 们 接 下 来 就 可 以 使 用 测试 伏 员 对 程序 进行 测试 了 。 


因为 handleRequest 函数 能 够 接受 任何 实现 了 Text 接口 的 结构 ， 
所 以 我 们 可 以 创建 出 一 个 实现 了 Text 接口 的 测试 替身 ， 并 把 它 作为 传 
递 给 handleRequest 函数 的 参数 。 代 码 清单 8-18 展 示 了 一 个 名 
AFakePost 的 测试 蔡 映 ， 以 及 它 为 了 满足 Text 接口 的 要 求 而 实现 的 几 





ITT IE 0 








代码 清单 8-18 FakePost 测试 替身 





package main 


type FakePost struct { 
Id int 
Content string 
Author string 

} 


func (post *FakePost) fetch(id int) (err error) { 
post.Id = id 
return 


} 


func (post *FakePost) create() (err error) { 
return 


} 


func (post *FakePost) update() (err error) { 
return 


} 


func (post *FakePost) delete() (err error) { 
return 


} 





注意 ， 为 了 进行 测试 ，fetch 方法 会 把 所 有 传递 给 它 的 ID 都 设置 
AFakePost 结构 的 ID。 此 外 ， 虽 然 FakePost 结构 的 其 他 方法 在 测试 
时 都 不 会 用 到 ， 但 是 为 了 满足 Text 接口 的 实现 要 求 ， 程 序 还 是 为 每 个 
方法 都 定义 了 一 个 没有 任何 实际 用 途 的 空 方法 。 为 了 保持 代码 的 清晰 ， 
这 些 测 试 蔡 身 代 码 被 放 到 了 doubles .go 文件 里 面 。 


接 下 来 ， 我 们 还 需要 在 server_test.go 文 件 里 为 handleGet 函数 
加 上 代码 清单 8-19 所 示 的 测试 用 例 。 














代码 清 





8-19 将 测试 蔡 身 依赖 注入 到 handleRequest 











func TestHandleGet(t *testing.T) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest(&FakePost{})) @ 


writer := httptest.NewRecorder() 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
t.Errorf("Response code is %v", writer.Code) 
} 
var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 
if post.Id != 1 { 
t.Errorf("Cannot retrieve JSON post") 
} 
} 





O 传 入 一 个 FakePost 结构 来 代替 Post 结构 


测试 用 例 现在 不 再 向 handleRequest 传递 Post 结构 ， 而 是 传递 一 
个 FakePost 结构 ， 这 个 结构 就 是 handleRequest 所 需 的 一 切 。 除 此 之 
外 ， 这 个 测试 用 例 跟 之 前 的 测试 用 例 没有 什么 不 同 。 





为 了 验证 测试 蔡 身 是 否 能 正常 工作 ， 我 们 可 以 在 关闭 数据 库 之 后 再 
次 运行 测试 用 例 。 在 这 种 情况 下 ， 旧 的 测试 用 例 将 会 因为 无 法 连接 数据 
库 而 失败 ， 而 使 用 了 测试 蔡 身 的 测试 用 例 则 因为 不 需要 实际 的 数据 库 而 
一 切 如 常 进行 。 这 也 意味 着 我 们 在 辛 苗 了 这 么 久之 后 ， 终 于 可 以 独立 地 
测试 handleGet 函数 了 。 





跟 之 前 的 测 斌 一样， 如 果 handleGet 函数 运作 正常 ， 那 么 测试 就 会 
通过 ;人 否则， 测试 束 会 失败 。 需 要 注意 的 是 ， 这 个 测试 用 例 并 没有 实际 


测试 Post 结构 的 fetch 方法 ， 这 是 因为 实施 这 种 测试 需要 对 posts 表 
执行 预 设 操作 和 拆 凶 操作 ， 而 重复 执行 这 种 操作 会 在 测试 时 耗费 大 量 的 
时 间 。 这 样 做 的 另 一 个 好 处 是 隔离 了 Web 服 务 的 各 个 部 分 ， 使 程序 员 可 
以 独立 测试 每 个 部 分 ， 并 在 发 现 问题 时 更 准确 地 定位 出 错 的 部 分 。 因 为 
代码 总 是 在 不 断 地 演进 和 变化 当中 ， 所 以 能 够 做 到 这 一 点 是 非常 重要 
的 。 在 代码 不 断 衍化 的 过 程 中 ， 我 们 必须 保证 后 续 添 加 的 部 分 不 会 对 前 
面 已 有 的 部 分 造成 破坏 。 





8.5 = Gol 





testing 包 是 一 种 简单 晶 高 效 的 测试 Go 程序 的 方法 ， 它 甚至 还 被 
用 于 验证 Go 自身 的 标准 库 ， 但 是 为 了 满足 一 些 领域 淘 望 拥有 更 多 功能 
的 要 求 ， 市 面 上 也 出 现 了 不 少 对 testing 包 进 行 增强 的 Go 测试 库 。 本 
节 将 对 Gocheck 和 Ginkgo 这 两 个 流行 的 Go 测试 库 进行 介绍 。Gocheck 是 
两 者 中 较为 简单 的 一 个 ， 它 整合 并 扩展 了 testing 包 ; Ginkgo 能 够 让 用 
户 在 Go 中 实现 行为 驱动 开发 ， 但 这 个 库 比 较 复杂 ， 而 且 学 习 曲 线 也 比 
BE BER 





8.5.1 Gocheck 测 试 包 简 介 





Gocheck 项 目 提 供 了 check 包 ， 这 个 包 是 基于 testing 包 构 建 的 一 
个 测试 框架 ， 并 且 提 供 了 一 系列 特性 来 填补 标准 testing 包 在 特性 方面 
的 空白 ， 这 一 系列 特性 包括 : 





以 套件 (suite〉 为 单位 对 测试 进行 分 组 ; 

为 每 个 测试 套件 或 者 测试 用 例 分 别 设置 测试 夹具 ; 
带 有 可 扩展 检查 器 接口 的 断言 ; 

更 多 错误 报告 辅助 函数 ; 

与 testing 包 紧 密集 成 。 





下 载 并 安装 check 包 的 工作 非 第 简单 ， 可 以 通过 执行 以 下 命令 来 完 
成 : 


go get gopkg.in/check.v1 


代码 清单 8-20 展 示 了 使 用 check 包 测试 简单 Web 服 务 的 方法 。 


























代码 清单 8-20 使 用 check 包 的 server_test.go 

















package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 
. "gopkg.in/check.v1" @ 
) 


type PostTestSuite struct {} @ 


func init() { 
Suite(&PostTestSuite{}) © 


func Test(t *testing.T) { TestingT(t) } @ 


func (s *PostTestSuite) TestHandleGet(c *C) { 
mux := http.NewServeMux() 
mux.HandleFunc("/post/", handleRequest (&FakePost{})) 
writer := httptest.NewRecorder() 
request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


c.Check(writer.Code, Equals, 200) © 

var post Post © 
json.Unmarshal(writer.Body.Bytes(), &post) © 
c.Check(post.Id, Equals, 1) © 





@ 导入 check 包 中 的 标识 符 ， 使 程序 可 以 以 不 带 前 缀 的 方式 访问 它 
们 


O 创建 测试 套件 
O 注册 测试 套件 
O 集成 testing 包 


O 检查 语句 的 执行 结 





这 个 测试 程序 做 的 第 一 件 事 束 是 导入 包 。 需 要 特别 注意 的 是 ， 因 为 
程序 是 以 点 〈. ) 方式 导入 check 包 的 ， 所 以 包 中 所 有 被 导出 的 标识 符 
在 测试 程序 里面 都 可 以 以 不 珊 前 级 的 方式 访问 。 





之 后 ， 程 序 创 建 了 一 个 测试 套件 。 测 试 套件 将 以 结构 的 形式 表示 ， 
这 个 结构 既 可 以 像 这 个 例子 中 展示 的 一 样 一 一 只 是 一 个 空 结构 ， 也 可 以 
在 结构 中 包含 其 他 字段 ， 这 一 点 在 后 面 将 会 有 更 详细 的 讨论 。 除 了 创建 
测试 套件 结构 之 外 ， 程 序 还 需要 把 这 个 结构 传递 给 Suite 函数 ， 以 便 对 
测试 倒 件 进行 注册 。 测 试 套件 中 所 有 遵循 TestXxx 格式 的 方法 都 会 被 看 
作 是 一 个 测试 用 例 ， 跟 之 前 一 样 ， 这 些 测试 用 例 也 会 在 用 户 运 行 测 试 时 
被 执行 。 





准备 工作 的 最 后 一 步 是 集成 testing 包 ， 这 一 点 可 以 通过 创建 一 个 
普通 的 testing 包 测 试用 例 来 完成 : 程序 需要 创建 一 个 格式 为 TestXxx 
的 函数 ， 它 接受 一 个 指向 testing.T 的 指针 作为 输入 ， 然 后 把 这 个 指针 
作为 参数 在 函数 体内 调用 TestingT 函数 。 


上 述 集成 操作 会 导致 所 有 用 Suite 函数 注册 了 的 测试 套件 被 运行 ， 
而 运行 的 结果 则 会 被 回 传 至 testing 包 。 在 一 切 预 设 操作 都 准备 妥当 之 
后 ， 程 序 接 下 来 就 可 以 定义 目 己 的 测试 用 例 了 。 在 上 面 展示 的 训 试 套件 





当中 ， 有 一 个 名 为 TestHandleGet 的 方法 ， 它 接受 一 个 指向 C 类 型 的 指 
针 作 为 参数 ， 这 种 类 型 拥有 一 些 非 常 有 趣 的 方法 ， 但 是 由 于 篇 幅 的 关 
系 ， 本 节 无 法 详细 介绍 C 类 型 拥有 的 所 有 方法 ， 目 前 来 说 ， 我 们 只 需要 
知道 它 的 Check 方法 和 Assert 方法 能 够 验证 结果 的 值 就 可 以 了 。 








例如 ， 在 代码 清单 8-20 中 ， 测 试用 例会 使 用 Check 方法 检查 被 返回 
的 HTTP 代 码 是 否 为 200， 如 果 结 果 不 是 200， 那 么 这 个 测试 用 例 将 被 标 
记 为 “已 失败 ”， 但 测试 用 例会 继续 执行 直到 结束 ; 反之， 如 果 程 序 使 
用 Assert {Check ， 那 么 测试 用 例 在 失败 之 后 将 立即 返回 。 


使 用 Gocheck 实 现 的 测试 程序 同样 使 用 go test 命令 执行 ， 但 是 用 
户 可 以 使 用 check 包 专 有 的 特别 详细 Cextra verbose) 标志 -check.vv 
显示 更 多 细节 ; 


go test -check.vv 


下 面 是 这 条 命令 的 执行 结果 : 





START: server_test.go:19: PostTestSuite.TestGetPost 

PASS: server_test.go:19: PostTestSuite.TestGetPost 0.00@s 
OK: 1 passed 

PASS 


ok gocheck 0.007s 





正如 结果 所 示 ， 带 有 特别 详细 标志 的 命令 给 我 们 提供 了 更 多 信息 ， 
其 中 包括 测试 的 启动 信息 。 虽 然 这 些 信息 对 于 目前 这 个 例子 没有 太 大 帮 
助 ， 但 是 在 之 后 的 例子 中 ， 我 们 将 会 看 到 这 些 信息 的 重要 之 处 。 





为 了 观察 测试 程序 在 出 错时 的 反应 ， 我 们 可 以 小 小 地 修改 一 
下 handleGet 函数 ， 把 以 下 这 个 会 抛 出 HITTP 404 状 态 码 的 语句 添加 到 
函数 的 return 语句 之 前 : 


http.NotFound(w, r) 


现在 ， 再 执行 go test 命令 ， 我 们 将 看 到 以 下 结 


START: server_test.go:19: PostTestSuite.TestGetPost 
server_test.go:29: 
c.Check(post.Id, Equals, 1) 
. obtained int = 6 
. expected int = 1 


FAIL: server_test.go:19: PostTestSuite.TestGetPost 


OOPS: @ passed, 1 FAILED 
--- FAIL: Test (0.00s) 
FAIL 

exit status 1 


FAIL gocheck 0.007s 





正如 结果 所 示 ， 带 有 特别 详细 标志 的 go test 命令 在 测试 出 错时 将 
给 我 们 提供 非常 多 有 价值 的 信息 。 





测试 夹具 (test fixture) 是 check 包 提 供 的 另外 一 个 非常 有 用 的 特 
性 ， 用 户 可 以 通过 这 些 夹具 在 测试 开始 之 前 设置 好 固定 的 状态 ， 然 后 再 
在 测试 中 对 预期 的 状态 进行 检查 。 





check 包 为 整个 测试 套件 以 及 每 个 测试 用 例 分 别提 供 了 一 系列 预 设 


数 和 拆 凶 函数 。 比 如 ， 在 套件 开始 运行 之 前 运 


云 行 一 次 的 SetUpSuite 


PRI 
函数 ， 在 所 有 测试 都 运行 完毕 之 后 运行 一 次 的 TearDownSuite 函数 ， 


在 运行 每 个 测试 用 例 之 前 都 会 运行 一 次 的 SetUpTest K 


每 个 测试 用 例 之 后 都 会 运行 一 次 的 TearDownTest K 


函数 ， 


函数 。 


以 及 在 运行 





为 了 演示 这 些 测试 夹具 的 使 用 方法 ， 我 们 需要 复 用 之 前 展示 过 的 测 
如 果 我 们 仔细 地 观察 已 有 的 
测试 用 例 和 新 添加 的 测试 用 例 就 会 发 现 ， 在 每 个 测试 用 例 里 面 ， 都 出 现 


试 程序 ， 并 为 PUT 方法 添加 一 个 测试 用 例 。 





了 以 下 重复 代码 : 


mux := http.NewServeMux() 
mux.HandleFunc("/post/", handlePost(&FakePost{})) 


writer := httptest.NewRecorder() 





这 个 测试 程序 的 每 个 测试 用 例 都 会 创建 一 个 多 路 复 用 器 ， 并 调用 多 
路 复 用 器 的 HandleFunc 方法 ， 把 一 个 URL 和 一 个 处 理 器 绑 定 起 来 。 在 
此 之 后 ， 测 试用 例 还 需要 创建 一 个 ResponseRecorder 来 记录 请 求 的 响 





应 。 因 为 测试 套件 中 的 每 个 测试 用 例 都 需要 执行 这 两 个 
可 以 把 这 两 个 步骤 用 作 各 个 测试 用 例 的 夹具 


[e] 





步骤 ， 所 以 我 们 


代码 清单 8-21 展 示 了 使 用 夹具 之 后 的 server_test .go 。 


代码 清 





单 8-21 使 

















测试 夹具 








实现 的 测试 程序 








package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"testing" 


"strings" 
"gopkg.in/check.v1" 


type PostTestSuite struct { @ 
mux *http.ServeMux 
post *FakePost 
writer *httptest.ResponseRecorder 


} 


func init() { 
Suite(&PostTestSuite{}) 


} 
func Test(t *testing.T) { TestingT(t) } 


func (s *PostTestSuite) SetUpTest(c *C) { @ 
S.post = &FakePost{} 
s.mux = http.NewServeMux() 
s.mux.HandleFunc("/post/", handleRequest(s.post) ) 
s.writer = httptest.NewRecorder() 


} 


func (s *PostTestSuite) TestGetPost(c *C) { 
request, _ := http.NewRequest("GET", "/post/1", nil) 
S.mux.ServeHTTP(s.writer, request) 


c.Check(s.writer.Code, Equals, 200) 

var post Post 
json.Unmarshal(s.writer.Body.Bytes(), &post) 
c.Check(post.Id, Equals, 1) 


} 

func (s *PostTestSuite) TestPutPost(c *C) { 
json := strings .NewReader(`{"content":"Updated post","author":"Sau 
Sheong"}> ) 
request, _ := http.NewRequest("PUT", "/post/1", json) 


s.mux.ServeHTTP(s.writer, request) 


c.Check(s.writer.Code, Equals, 200) 
c.Check(s.post.Id, Equals, 1) 
c.Check(s.post.Content, Equals, "Updated post") 





@ 存储 在 测试 套件 中 的 测试 夹具 数据 


O 创建 测试 夹具 


为 了 使 用 测试 夹具 ， 程 序 必须 将 它 的 数据 存储 在 某 个 地 方 ， 并 让 这 
些 数据 在 测试 过 程 中 一 直 存 在 。 为 此 ， 程 序 需 要 给 测试 套件 结构 
PostTestSuite 添加 一 些 字段 ， 并 把 想 要 存储 的 测试 夹具 数据 记录 到 
这 些 字段 里 面 。 因 为 测试 套件 中 的 每 个 测试 用 例 实际 上 都 
jePostTestSuite 结构 的 一 个 方法 ， 所 以 这 些 测试 用 例 将 能 够 非常 方 
便 地 访问 到 结构 中 存储 的 夹具 数据 。 在 存储 好 夹具 数据 之 后 ， 程 序 会 使 
用 SetUpTest 疯 数 为 每 个 测试 用 例 设 置 夹具 。 














在 创建 夹具 的 过 程 中 ， 程 序 使 用 了 存储 在 PostTestSuite 结构 中 
的 字段 。 在 设置 好 夹具 之 后 ， 我 们 就 可 以 对 测试 程序 做 相应 的 修改 了 : 
需要 修改 的 地 方 并 不 多 ， 最 主要 的 工作 是 移 除 测试 用 例 中 重复 出 现 的 语 
句 ， 并 将 测试 用 例 中 使 用 的 结构 修改 为 测试 夹具 中 设置 的 结构 。 在 完成 
修改 之 后 再 次 执行 go test 命令 ， 我 们 将 得 到 以 下 结果 : 








START: server_test.go:31: PostTestSuite.TestGetPost 
START: server_test.go:24: PostTestSuite.SetUpTest 
PASS: server_test.go:24: PostTestSuite.SetUpTest 6.666s 


PASS: server_test.go:31: PostTestSuite.TestGetPost @.00Q@s 


START: server_test.go:41: PostTestSuite.TestPutPost 
START: server_test.go:24: PostTestSuite.SetUpTest 


PASS: server_test.go:24: PostTestSuite.SetUpTest 0.000s 


PASS: server_test.go:41: PostTestSuite.TestPutPost 0.00@s 


OK: 2 passed 
PASS 
ok gocheck 0.007s 





特别 详细 标志 让 我 们 清晰 地 看 到 了 整个 测试 套件 的 运行 过 程 。 为 了 
进一步 观察 整个 测试 套件 的 运行 顺序 ， 我 们 可 以 把 以 下 测试 夹具 函数 添 
加 到 测试 程序 里 面 : 


func (s *PostTestSuite) TearDownTest(c *C) { 
c.Log("Finished test - ", c.TestName() ) 

} 

func (s *PostTestSuite) SetUpSuite(c *C) { 
c.Log("Starting Post Test Suite") 


} 
func (s *PostTestSuite) TearDownSuite(c *C) { 


c.Log("Finishing Post Test Suite") 
} 





再 次 运行 测试 将 得 到 以 下 结果 





START: server_test.go:35: PostTestSuite.SetUpSuite 
Starting Post Test Suite 
PASS: server_test.go:35: PostTestSuite.SetUpSuite 6.666s 


START: server_test.go:44: PostTestSuite.TestGetPost 
START: server_test.go:24: PostTestSuite.SetUpTest 
PASS: server_test.go:24: PostTestSuite.SetUpTest 0.000s 


START: server_test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestGetPost 

PASS: server_test.go:31: PostTestSuite.TearDownTest 6.666s 
PASS: server_test.go:44: PostTestSuite.TestGetPost 0.00@s 
START: server_test.go:54: PostTestSuite.TestPutPost 

START: server_test.go:24: PostTestSuite.SetUpTest 

PASS: server_test.go:24: PostTestSuite.SetUpTest 0.000s 
START: server_test.go:31: PostTestSuite.TearDownTest 
Finished test - PostTestSuite.TestPutPost 

PASS: server_test.go:31: PostTestSuite.TearDownTest 6.666s 
PASS: server_test.go:54: PostTestSuite.TestPutPost 0.00@s 


START: server_test.go:39: PostTestSuite.TearDownSuite 


Finishing Post Test Suite 
PASS: server_test.go:39: PostTestSuite.TearDownSuite 6.666s 


OK: 2 passed 
PASS 
ok gocheck @.007s 





根据 测试 结果 显示 ，SetUpSuite 和 TearDownSuite 就 如 我 们 之 前 
介绍 的 一 样 ， 只 会 在 测试 开始 之 前 和 测试 结束 之 后 各 运行 一 次 ， 
而 SetUpTest 和 TearDownTest 则 会 作为 每 个 测试 用 例 的 第 一 行 语句 和 
最 后 一 行 语 句 ， 在 测试 用 例 的 开头 和 结尾 分 别 运行 一 次 。 


作为 testing 包 的 增强 版 本 ， 简 单 而 强大 的 Gocheck 为 我 们 的 测 
试 “军火 库 ” 加 上 了 一 件 强 有 力 的 武器 ， 如 果 你 想 要 获得 比 Gocheck 更 强 
大 的 功能 ， 可 以 试 一 试 下 一 节 介 绍 的 Ginkgo 测 试 框架 。 


8.5.2 Ginkgo 测试 框架 简介 


Ginkgo 是 一 个 行为 驱动 开发 〈behavior-driven development, BDD) 
风格 的 Go 测试 框架 。BDD 是 一 个 非常 庞大 的 主题 ， 想 要 在 小 小 的 一 节 
篇 幅 里 对 它 进行 完整 的 介绍 是 不 可 能 的 。 一 言 以 英之 ，BDD 是 测试 驱动 
开发 (test-driven development, TDD) 的 一 种 延伸 ， 但 BDD 跟 TDD 的 不 
同 之 处 在 于 ，BDD 是 一 种 软件 开发 方法 而 不 是 一 种 软件 测试 方法 。 在 
BDD 中 ， 软 件 由 它 的 目标 行为 进行 定义 ， 这 些 目标 行为 通常 是 一 系列 业 
务 需 求 。BDD 的 需求 是 从 行为 的 角度 ， 通 过 终端 用 户 的 语言 以 及 视角 来 
定义 的 ， 这 些 需 求 在 BDD 中 称 为 用 户 故 事 Cuser story) 。 下 面 是 通过 
用 户 故 事 对 简单 Web 服 务 进行 描述 的 一 个 例子 。 


| 





故事 


由 
. 


获取 一 张 帖 子 
为 了 




















向 用 户 显 示 指定 的 一 张 帖 子 
作为 

















一 个 被 调用 的 程序 




















获取 用 户 指定 的 帖子 


























一 个 值 为 ` 


` 的 帖子 ID 
只 要 


m 





我 发 送 一 个 带 有 该 ID 的 GET 请 求 
那么 








我 就 会 获得 与 给 定 ID 相 对 应 的 一 张 帖子 


情景 2: 

















使 用 一 个 非 整 数 ID 





一 个 值 为 `"hello" 


` 的 帖子 ID 





只 要 


我 发 送 一 个 带 有 该 ID 的 GET 请 求 
那么 








我 就 会 获得 一 个 HTTP 566 响 应 





在 定义 了 用 户 故 事 之 后 ， 我 们 就 可 以 把 这 些 用 户 故事 转换 为 测试 用 
例 。BDD 中 的 测试 用 例 跟 TDD 中 的 测试 用 例 一 样 ， 都 是 在 编写 实际 的 代 
码 之 前 编写 的 ， 这 些 测试 用 例 的 目标 在 于 开发 出 一 个 程序 ， 让 它 能 够 执 
行 用 户 故 事 中 描述 的 行为 。 坦 白地 说， 上 面 展 示 的 用 户 故 事 带 有 很 明显 
的 虚构 成 分 。 在 更 现实 的 环境 中 ，BDD 用 户 故 事 最 开始 通常 都 是 使 用 更 
局 层次 的 语言 来 撰写 ， 然 后 根据 细 市 进行 数 次 层级 划分 之 后 ， 表 分 解 为 
更 为 具体 的 用 户 故 事 ， 最 终 ， 使 用 高 层次 语言 撰写 的 用 户 故 事 将 会 被 映 
财 到 一 系列 按 层级 划分 的 测试 套件 。 








Ginkgo 是 一 个 拥有 丰富 功能 的 BDD 风 格 的 框架 ， 它 提供 了 将 用 户 故 
事 映 射 为 测试 用 例 的 工具 ， 并 且 这 些 工 具 也 很 好 地 集成 到 了 Go 的 
testing 包 当 中 。 昌 然 Ginkgo 的 主要 用 于 在 Go 中 实现 BDD， 但 是 本 市 
只 会 把 Ginkgo 当 作 一 个 Go 的 测试 框架 来 使 用 。 


为 了 安装 Ginkgo， 我 们 需要 在 终 闪 中 执行 以 下 两 条 命令 : 


go get github.com/onsi/ginkgo/ginkgo 
go get github.com/onsi/gomega 


第 一 条 命令 下 载 Ginkgo 并 将 命令 行 接口 程序 ginkgo 安装 
到 $GOPATH/bin 目录 中 ， 而 第 二 条 命令 则 会 下 载 Ginkgo 默 认 的 匹配 器 


库 Gomega〈 匹 配器 可 以 对 比 两 个 不 同 的 组 件 ， 这 些 组 件 可 以 是 结构 、 
BRN. AERP ER SE) 。 


在 开始 学 习 如 何 使 用 Ginkgo 编 写 测试 用 例 之 前 ， 让 我 们 先 来 看 看 如 
何 使 用 Ginkgo 去 执行 已 有 的 测试 用 例 一 一 Ginkgo 能 够 自动 地 对 前 面 展示 
过 的 testing 包 测 试用 例 进行 语法 重 写 ， 把 它们 转换 为 Ginkgo 测 试用 
例 。 








为 了 验证 这 一 点 ， 我 们 将 会 使 用 上 一 节 展 示 过 的 带 有 依赖 注入 特性 
的 测试 套件 为 起 点 。 如 果 你 想 要 保留 原 有 的 测试 套件 ， 让 它们 免 受 
Ginkgo 的 修改 ， 那 么 请 在 执行 后 续 操 作 之 前 先 对 其 进行 备份 。 在 一 切 准 
备 就 绪 之 后 ， 在 终端 里 面 执行 以 下 命令 : 


ginkgo convert . 


这 条 命令 会 在 目录 中 添加 一 个 名 为 XXX _suite_test.go 的 文件 ， 其 中 
Xxx 为 目录 的 名 字 。 这 个 文件 的 具体 内 容 如 代码 清单 8-22 所 示 。 














代码 清单 8-22 Ginkgo 测试 套件 文件 











package main_test 


import ( 
. "github.com/onsi/ginkgo" 
. "github.com/onsi/gomega" 


"testing" 


func TestGinkgo(t *testing.T) { 
RegisterFailHandler (Fail) 
RunSpecs(t, "Ginkgo Suite") 

} 


pT 


除 此 之 外 ， 上 述 命令 还 会 对 server_test.go 文 件 进行 修改 ， 代 码 
清单 8-23 中 以 粗 体 的 形式 展示 了 文件 中 被 修改 的 代码 行 。 











代码 清单 8-23 ”修改 后 的 测试 文件 

















package main 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"strings" 
. "github.com/onsi/ginkgo" 


) 


var _ = Describe("Testing with Ginkgo", func() { 


It("get post", func() { 


mux := http.NewServeMux() 

mux.HandleFunc("/post/", handleRequest(&FakePost{})) 
writer := httptest.NewRecorder() 

request, _ := http.NewRequest("GET", "/post/1", nil) 
mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
GinkgoT().Errorf("Response code is %v", writer.Code) 


} 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 


}) 


if post.Id != 1 { 
GinkgoT().Errorf("Cannot retrieve JSON post") 


}) 


It("put post", func() { 


mux := http.NewServeMux() 
post := &FakePost{} 
mux.HandleFunc("/post/", handleRequest(post)) 


writer := httptest.NewRecorder() 


json := strings.NewReader( {"content": "Updated post", "author" :" 
Sheong"} ) 
request, _ := http.NewRequest("PUT", "/post/1", json) 


mux.ServeHTTP(writer, request) 


if writer.Code != 200 { 
GinkgoT().Error("Response code is %v", writer.Code) 


} 


if post.Content != "Updated post" { 
GinkgoT().Error("Content is not correct", post.Content) 


}) 


Sau 








注意 ， 修 改 后 的 测试 程序 并 没有 使 用 Gomega， 只 是 把 检查 执行 结 
果 的 语句 改 成 了 Ginkgo 提 供 的 Errorf 函数 和 Error 函 数 ， 不 过 这 两 个 
函数 跟 testing aaa 包 中 的 同名 函数 具有 相似 的 作用 。 当 我 们 
使 用 以 下 命令 运行 这 个 测试 程序 时 : 


Ginkgo 将 打印 出 一 段 格式 非常 漂亮 的 输出 : 


Running Suite: Ginkgo Suite 


Random Seed: 1431743149 
Will run 2 of 2 specs 
Testing with Ginkgo 
get post 
server_test.go:29 


Testing with Ginkgo 
put post 
server_test.go:48 
Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | © Failed | © Pending | ð Skipped PASS 


Ginkgo ran 1 suite in 577.104764ms 
Test Suite Passed 





目 动 转换 己 有 的 测试 ， 然 后 漂亮 地 打印 出 它们 的 执行 结果 ， 这 给 人 
的 感觉 真 的 非常 不 错 ! 但 如 果 我 们 根本 没有 现成 的 测试 用 例 ， 是 否 需 要 
先 创建 出 testing 包 的 测试 用 例 ， 然 后 再 把 它们 转换 为 Ginkgo 测 试 呢 ? 
答案 是 人 否定 的 ! 没有 必要 多 此 一 举 ， 让 我 们 来 看 看 如 何 从 零 开 始 创建 


Ginkgo 训 试用 例 吧 。 





Ginkgo 提 供 了 一 些 实用 工具 ， 它 们 能 够 帮助 用 户 快速 、 方 便 地 创建 
测试 。 首 先 ， 清 空 与 上 一 次 测试 有 关 的 全 部 测试 文件 ， 包 括 之 前 Ginkgo 
创建 的 测试 套件 文件 ， 然 后 在 程序 的 目录 中 执行 以 下 两 条 命令 : 








ginkgo bootstrap 
ginkgo generate 








第 一 条 命令 会 创建 新 的 Ginkgo 测 试 套件 文件 ， 而 第 二 条 命令 则 会 为 
测试 用 例文 件 生 成 代码 清单 8-24 所 示 的 骨架 。 














代码 清单 8-24 ” Ginkgo 测试 文件 











package main test 


import ( 
. "<path/to/your/go_files>/ginkgo" 
. "github.com/onsi/ginkgo" 
. "github.com/onsi/gomega" 


_ = Describe("Ginkgo", func() { 





注意 ， 因 为 Ginkgo 会 把 测试 用 例 从 main 包 中 隔离 开 ， 所 以 新 创建 
的 测试 文件 将 不 再 属于 main 包 。 此 外 ， 测 试 程序 还 通过 点 导入 Cdot 
import) 语法 ， 将 几 个 库 中 包含 的 标识 符 全 部 导入 到 顶层 命名 空间 。 这 
种 导入 方式 并 不 是 必需 的 ，Ginkgo 在 它 的 文档 里 面 提 供 了 一 些 关 于 如 何 
避免 这 种 导入 的 说 明 ， 但 是 在 不 使 用 点 导入 语法 的 情况 下 ， 用 户 必 须 导 





出 main 包 中 需要 使 用 Ginkgo 测 试 的 所 有 函数 。 例 如 ， 因 为 我 们 接 下 来 
就 要 对 简单 Web 服 务 的 HandleRequest 函数 进行 测试 ， 所 以 这 个 函数 
一 定 要 被 导出 ， 也 就 是 说 ， 这 个 函数 的 名 字 的 首 字母 必须 大 写 。 





另外 需要 注意 的 是 ，Ginkgo 在 调用 Describe 函数 时 使 用 了 var 
这 一 技巧 。 这 种 常用 的 技巧 能 够 在 调用 Describe 函数 的 同时 ， 避 
免 引 入 init 函数 。 


代码 清单 8-25 展 示 了 使 用 Ginkgo 实 现 的 测试 用 例 代 码 ， 这 些 代 码 是 
由 早 前 撰写 的 用 户 故 事 映 射 而 来 的 。 





代码 清单 8-25 ”使 用 Gomega 匹 配器 实现 的 Ginkgo 测 试用 例 











package main_test 


import ( 
"encoding/json" 
"net/http" 
"net/http/httptest" 
"github.com/onsi/ginkgo" 
"github.com/onsi/gomega" 
"gwp/Chapter 8 Testing Web Applications/test ginkgo" 


var _ = Describe("Get a post", func() { @ 
var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost{} 
mux = http.NewServeMux() 
mux.HandleFunc("/post/", HandleRequest (post) ) 
writer = httptest.NewRecorder() 


}) 


Context( "Get a post using an id", func() { ee 
It("should get a post", func() { 
request, _ := http.NewRequest("GET", "/post/1", nil) 


mux.ServeHTTP(writer, request) 
Expect(writer.Code).To(Equal(200)) @ 


var post Post 
json.Unmarshal(writer.Body.Bytes(), &post) 


Expect(post.Id).To(Equal(1)) 
}) 
}) 


Context("Get an error if post id is not an integer", func() { © 
It("should get a HTTP 566 response", func() { 
request, _ := http.NewRequest("GET", "/post/hello", nil) 
mux.ServeHTTP(writer, request) 


Expect(writer.Code) .To(Equal(5@@) ) 





@ 用 户 故 事 


© 使 用 Gomega 匹 配器 

© 情景 1 

© 使 用 Gomega 对 正确 性 进行 断言 
O 情景 2 


注意 ， 这 个 测试 程序 使 用 了 来 自 Gomega 包 的 匹配 器 : Gomega 是 由 
Ginkgo 开 发 者 开发 的 一 个 断言 包 ， 包 中 的 匹配 器 都 是 测试 断言 。 ate 
用 check 包 时 一 样 ， 测 试 程序 在 调用 Context 函数 模拟 指定 的 情景 之 
前 ， 会 完 设 置 好 相应 的 测试 夹具 : 


var mux *http.ServeMux 
var post *FakePost 
var writer *httptest.ResponseRecorder 


BeforeEach(func() { 
post = &FakePost{} 
mux = http.NewServeMux() 
mux.HandleFunc("/post/", HandleRequest(post)) @ 
writer = httptest.NewRecorder() 

}) 





@ 对 main 包 中 导出 的 函数 进行 测试 


注意 ， 为 了 从 main 包 中 导出 被 测试 的 处 理 器 ， 我 们 将 处 理 器 的 名 
字 从 原来 的 handleRequest 修改 成 了 首 字母 大 写 的 HandleRequest 。 
除 使 用 的 是 Gomega 的 断言 之 外 ， 程 序 中 展现 的 测试 场景 跟 我 们 之 前 使 
用 其 他 包 进 行 测 试 时 的 场景 非常 类 似 。 下 面 是 一 个 使 用 Gomega 创 建 的 
Wt 


Expect (post.Id).To(Equal(1)) 


在 这 个 断言 中 ，post.Id 是 要 测试 的 对 象 ，Equal 函数 是 匹配 器 ， 
而 1 是 预期 的 结果 。 针 对 我 们 写 的 测试 情景 ， 执 行 ginkgo 命令 将 返回 
以 下 结果 : 





Running Suite: Post CRUD Suite 


Random Seed: 1431753578 
Will run 2 of 2 specs 


Get a post using an id 
should get a post 
test ginkgo test.go:35 


Get a post using a non-integer id 
should get aHTTP50@ response 
test ginkgo test.go:44 
Ran 2 of 2 Specs in 0.000 seconds 
SUCCESS! -- 2 Passed | © Failed | © Pending | ð Skipped PASS 


Ginkgo ran 1 suite in 648.619232ms 
Test Suite Passed 
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下 来 的 一 章 中 ， 我 们 将 会 讨论 如 何在 Web 应 用 中 使 用 Go 的 一 个 关键 长 处 
一 一 并 友 。 


8.6 ”小 结 


。 Go 通过 go test 命令 为 用 户 提 供 了 内 置 的 测试 工具 ， 并 提供 了 
testing 包 以 便 实现 单元 测试 。 

e testing 包 提 供 了 基本 的 功能 测试 以 及 基准 测试 能 力 。 

。 对 于 Go 语言 来 说 ，Web 应 用 的 单元 测试 可 以 通过 
testing/httptest 包 来 完成 。 

。 使 用 测试 替身 可 以 让 测试 用 例 变 得 更 加 独立 。 

。 实现 测试 蔡 身 的 一 种 方法 是 使 用 依赖 注入 设计 模式 。 

。 Go 语言 拥有 许多 第 三 方 测试 库 ， 其 中 包括 对 Go 的 测试 功能 进行 扩 
展 的 Gocheck 包 ， 以 及 实现 了 行为 驱动 测试 的 Ginkgo 包 。 











PIE ”发 挥 Go 的 并 发 优势 


本 章 主要 内 容 


。 从 原理 上 理解 并 发 和 并 行 
。 学 习 如 何 使 用 goroutine 以 及 通道 
。 在 Web 应 用 中 使 用 并 发 特性 








Go 语言 一 个 广为人知 的 特点 就 是 ， 可 以 更 容易 地 写 出 错误 更 少 的 
并 发 程序 。 本 章 将 介绍 并 发 这 一 技术 ， 并 讨论 Go 语言 的 并 发 模型 以 及 
设计 。 除 此 之 外 ， 我 们 还 会 深入 地 了 解 Go 语言 为 实现 并 发 而 提供 的 两 
个 特性 ， 它 们 分 别 是 goroutine 以 及 通道 。 在 本 章 的 最 后 ， 我 们 还 会 看 到 
一 个 使 用 Go 并 发 提高 Web 应 用 性 能 的 例子 。 





9.1 并 及 与 并 行 的 区 别 


并 发 (concurrency) 指 的 是 两 个 或 多 个 任务 在 同一 时 间 段 内 启动、 
运行 并 结束 ， 并 且 这 些 任务 可 能 会 互动 。 以 并 发 形式 执行 的 多 个 任务 会 
同时 存在 ， 这 跟 顺 序 执行 每 次 只 会 存在 一 个 任务 的 情况 正好 相反 。 并 发 
是 一 个 非常 庞大 且 复 杂 的 主题 ， 本 章 将 会 简单 介绍 这 一 主题 。 








并 行 与 并 发 是 两 个 看 上 去 相似 但 实际 上 却 截 然 不 同 的 概念 ， 因 为 并 
发 和 并 行 都 可 以 同时 运行 多 个 任务 ， 所 以 很 多 人 都 把 这 两 个 概念 混 消 
了 。 对 于 并 发 来 说 ， 多 个 任务 并 不 需要 同时 开始 或 者 同时 结束 一 一 这 些 
任务 的 执行 过 程 在 时 间 上 是 相互 重 登 的 。 并 发 执行 的 多 个 任务 会 被 调 
度 ， 并 且 它 们 会 通过 通信 分 至 数据 并 协调 执行 时 间 (不 过 这 种 通信 并 不 
是 必须 的 〉。 





在 并 行 (parallelism) 中 ， 多 个 任务 将 同时 启动 并 执行 。 并 行 通 第 
会 把 一 个 大 任务 分 割 成 多 个 更 小 的 任务 ， 然 后 通过 同时 执行 这 些小 任务 
来 提高 性 能 。 并 行 通 常 需要 独立 的 资源 〈 如 CPU) ， 而 并 发 则 会 使 用 和 
分 享 相同 的 资源 。 因 为 并 行 考虑 的 是 同时 启动 和 执行 多 个 任务 ， 所 以 它 
在 直觉 上 会 更 易 懂 一 些 。 并 行 ， 正 如 它 的 名 字 所 昭示 的 那样 ， 是 一 系列 
相互 平行 、 不 会 重 登 的 处 理 过 程 。 


并 发 指 的 是 同时 处 理 多 项 任务 ， 而 并 行 指 的 是 同时 执行 多 项 任务 。 














—Rob Pike，Go 语 言 的 作者 之 一 





— an 种 方法 是 把 它 看 作 超市 里 的 两 条 结账 通道 ， 但 这 两 
ia 
如 图 9-1 所 示 。 


“F000 
T 


图 9-1 并 发 一 一 两 条 结 ， 但 是 只 有 一 个 收银 台 


男 一 方面 ， 并 行 同样 拥有 两 条 结账 通道 ， 只 是 每 条 通道 都 有 一 个 对 
应 的 收银 台 为 顾客 服务 ， 如 图 9-2 所 示 。 


h 





图 9-2 ”并行 一 一 两 条 结账 通道 ， 每 条 都 对 应 一 个 收银 台 





尽管 并 发 和 并 行 在 概念 上 并 不 相同 ， 但 它们 并 不 相互 排斥 ， 比 如 
Go 语言 就 可 以 创建 出 同时 具有 并 发 和 并 行 这 两 种 特征 的 程序 。 为 了 让 
并 行程 序 可 以 同时 运行 多 个 任务 ，Go 语 言 的 用 户 需 要 将 环境 变量 
GOMAXPROCS 的 值 设 置 成 大 于 1 。 在 Go 1.5 版 本 之 前 ，GOMAXPROCS 默认 
会 被 设置 为 1 ， 但 是 从 Go 1.5 版 本 开始 ，GOMAXPROCS 默认 将 被 设置 为 
系统 可 用 的 CPU 数量 。 但 是 ， 并 发 程序 可 以 在 单个 CPU 上 运行 ， 至 于 程 
序 包 含 的 多 个 任务 则 会 通过 调度 独立 地 运行 ， 本 章 稍 后 就 会 出 现 一 个 这 
样 的 例子 。 需 要 注意 的 是 ， 尽 管 Go 语 言 可 以 用 于 创建 并 行程 序 ， 但 这 
门 语言 在 设计 时 考虑 的 更 多 是 并 发 而 不 是 并 行 。 

















Go 语言 通过 goroutine 和 通道 这 两 个 主要 组 件 来 为 并 发 提供 文 持 ， 在 
接 下 来 几 节 中 ， 我 们 将 会 看 到 使 用 goroutine、 通 道 以 及 一 些 标准 库 来 构 
建 并 发 程序 的 具体 方法 。 





9.2 goroutine 


goroutine 指 的 是 那些 独立 于 其 他 goroutine 运 行 的 函数 。 这 一 概念 初 
看 上 去 和 线程 有 些 相 似 ， 但 实际 上 goroutine 并 不 是 线程 ， 它 只 是 对 线程 
的 多 路 复 用 。 因 为 goroutine 都 是 轻 量 级 的 ， 所 以 goroutine 的 数量 可 以 比 
线程 的 数量 多 很 多 。 一 个 goroutine 在 启动 时 只 需要 一 个 非常 小 的 栈 ， 并 
且 这 个 栈 可 以 按 需 扩展 和 缩小 〈 在 Go 1.4 中 ，goroutine 启 动 时 的 栈 大 小 
MA2KB"!) 。 当 一 个 goroutine 被 阻塞 时 ， 它 也 会 阻塞 所 复 用 的 操作 
系统 线程 ， 而 运行 时 环境 (runtime) 则 会 把 位 于 被 阻塞 线程 上 的 其 他 
goroutine 移 动 到 其 他 未 阻 罕 的 线程 上 继续 运行 


9.2.1 使 用 goroutine 


goroutine 的 用 法 非常 简单 : 只 要 把 go 关键 字 添 加 到 任意 一 个 具名 也 
数 或 者 匿名 函数 的 前 面 ， 访 函数 就 会 成 为 一 个 goroutine。 作 为 例子 ， 代 
码 清单 9-1 展 示 了 如 何在 名 为 goroutine.go 的 文件 中 创建 goroutine。 





代码 清单 9-1 ”goroutine 使 用 示例 











package main 


func printNumbers1() { 
for i := 0; i < 10; i++ { 
fmt.Printf("%d ", i) 


} 


func printLetters1() { 
for i := 'A'; i < 'A'+10; i++ { 
fmt.Printf("%c ", i) 
} 
} 


func printi() { 
printNumbers1() 
printLetters1() 
} 


func goPrint1() { 
go printNumbers1() 
go printLetters1() 
} 


func main() { 


} 





goroutine.go 文 件 中 定义 了 printNumbers1 #lprintLetters1 
两 个 函数 ， 分 别 用 于 循环 并 打印 数字 和 英文 字母 ， 其 中 printNumbers1 
会 打印 从 8 到 9 的 所 有 数字 ， 而 printLetters1 则 会 打印 从 A 到 ] 的 所 
有 英文 字母 。 除 此 之 外 ，goroutine.go 文 件 中 还 定义 了 print1 和 
goPrint1 两 个 函数 ， 前 者 会 依次 调用 printNumbers1 和 
printLetters1 ， 而 后 者 则 会 以 goroutine 的 形式 调用 printNumbers1 
AlprintLetters1 。 





为 了 检测 这 个 程序 的 运行 时 间 ， 我 们 将 通过 测试 而 不 是 main 函数 
来 运行 程序 中 的 print1 函数 和 goPrint1 函数 。 这 样 一 来 ， 我 们 就 不 必 
为 了 测量 这 两 个 函数 的 运行 时 间 而 编写 测量 代码 ， 这 也 避免 了 因为 编写 
计时 代码 而 导致 测量 不 准确 的 问题 。 











代码 清单 9-2 展 示 了 测试 用 例 的 具体 代码 ， 这 些 代 码 单 独 记 录 在 了 
goroutine test.go 文 件 当中 。 














代码 清单 9-2 ”运行 goroutine 示 例 的 测试 文件 














package main 


import "testing" 


func TestPrint1(t *testing.T) { ©@ 
print1() 
} 


func TestGoPrint1(t *testing.T) { @ 
goPrint1() 
} 





@ 测试 顺序 执行 的 函数 
四 测试 对 以 goroutine 形式 执行 的 函数 


通过 使 用 以 下 命令 执行 这 一 测试 : 


和 


我 们 将 得 到 以 下 结果 ; 


UN TestPrint1 

3456789ABCDEFGHI J --- PASS: TestPrint1 (0.00s) 
UN TestGoPrint1 
ASS: TestGoPrint1 (0.00s) 





注意 ， 第 二 个 测试 用 例 并 没有 产生 任何 输出 ， 这 是 因为 该 用 例 在 它 
的 两 个 goroutine 能 够 产生 输出 之 前 束 已 经 结束 了 。 为 了 让 第 二 个 测试 用 
例 能 够 正常 地 产生 输出 ， 我 们 需要 使 用 time 包 中 的 Sleep 函数 ， 在 第 
二 个 测试 用 例 的 末尾 加 上 一 些 延迟 : 


func TestGoPrint1i(t *testing.T) { 
goPrint1() 
time.Sleep(1 * time.Millisecond) 








这 样 一 来 ， 第 二 个 测试 用 例 就 会 在 该 测试 用 例 结束 之 前 正常 地 产生 


789ABCDEFGHI J --- PASS: TestPrint1 (0.00s) 


oPrint1 
789ABCDEFGH IJ --- PASS: TestGoPrint1 (0.00s) 





这 两 个 测试 用 例 都 产生 了 相同 的 结果 。 初 看 上 去 ， 是 否 使 用 
goroutine 似 乎 并 没有 什么 不 同 ， 但 事实 上 ， 这 两 个 测试 用 例 之 所 以 会 产 
生 相 同 的 结果 ， 是 因为 printNumbers1 函数 和 printLettersl 函数 都 

运行 得 如 此 之 快 ， 所 以 是 否 以 goroutine 形 式 运 行 它们 并 不 会 产生 任何 区 
别 。 为 了 更 准确 地 模拟 正常 的 计算 任务 ， 我 们 将 通过 time 包 中 的 Sleep 
函数 人 为 地 给 这 两 个 函数 加 上 一 点 延迟 ， 并 把 带 有 延迟 的 函数 重新 命名 
为 printNumbers2 和 printLetters2 。 代 码 清单 9-3 展 示 了 这 两 个 新 函 
数 ， 跟 原来 的 函数 一 样 ， 它 们 也 会 被 放 在 goroutine.go 文 件 中 。 

















代码 清 








9-3 ”模拟 执行 计算 任务 的 goroutine 











func printNumbers2() { 
for i := 0; i < 10; i++ { 
time.Sleep(1 * time.Microsecond @ 
fmt.Printf("%d ", i) @ 
}@ 
}@ 


func printLetters2() { @ 
for i := 'A'; i < 'A'+10; i++ { @ 
time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i)e 
} 
} 


func goPrint2() { 
go printNumbers2() 
go printLetters2() 
} 





@ 添加 1 ps 的 延迟 ， 用 于 模拟 计算 任务 


新 定义 的 两 个 函数 通过 在 每 次 迭代 中 添加 1s 的 延 人 运 来 模拟 计算 任 
务 。 为 了 测试 新 添加 的 goPrint2 函数 ， 我 们 将 在 goroutine_test.go 
文件 中 添加 相应 的 测试 用 例 ， 并 且 和 之 前 一 样 ， 为 了 让 被 测试 的 函数 
能 够 正常 地 产生 输出 ， 测 试用 例 将 在 调用 goPrint2 函数 之 后 等 待 1hs: 


func TestGoPrint2(t *testing.T) { 
goPrint2() 
time.Sleep(1 * time.Millisecond) 


} 





现在 ， 运 行 测试 用 例 将 得 到 以 下 输出 : 


G 


TestPrint1 

456789ABCDEFGHIJ --- PASS: TestPrint1 (0.00s) 
TestGoPrint1 

456789ABCDEFGHIJ --- PASS: TestGoPrint1 (0.00s) 
TestGoPrint2 

CD2E3F4GH51I6J789 --- PASS: TestGoPrint2 (0.00s) 
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注意 看 TestGoPrint2 函数 的 输出 结果 ， 从 结果 可 以 看 出 ， 程 序 这 
次 并 不 是 先 执 行 printNumbers2 函数 ， 然 后 再 执行 printLetters2 fA 
数 ， 而 是 交 蔡 地 执行 它们 ! 


如 果 我 们 再 执行 一 次 这 个 测试 ， 那 么 TestGoPrint2 函数 的 输出 结 
果 的 最 后 一 行 可 能 会 有 所 不 同 : 这 是 因为 printNumbers2 和 
printLetters2 都 是 独立 运行 的 ， 并 且 它 们 都 在 争先 恕 后 地 想 要 将 日 
己 的 结 末 输 出 到 屏幕 上 ， 上 所 以 随 着 这 两 个 函数 的 执行 顺序 不 同 ， 测 试 产 
生 的 结果 也 会 有 所 不 同 。 唯 一 的 例外 是 ， 如 果 你 使 用 的 是 Go 1.5 之 前 的 
版 本 ， 那 么 你 每 次 执行 这 个 测试 都 会 得 到 相同 的 结果 。 





之 所 以 会 出 现 这 种 情况 ， 是 因为 Go 1.5 之 前 的 版 本 在 用 户 没 有 另行 
设置 的 情况 下 ， 即 使 计算 机 拥有 多 于 一 个 CPU， 它 默认 也 只 会 使 用 一 个 
CPU。 但 是 从 Go 1.5 开 始 ， 这 一 情况 发 生 了 改变 一 一 Go 运行 时 环境 会 使 
用 计算 机 拥有 的 全 部 CPU。 在 Go 1.5 或 以 后 的 版 本 中 ， 用 户 如 果 想 要 让 
Go 运行 时 环境 只 使 用 一 个 CPU， 就 需要 执行 以 下 命令 : 


go test -run x -bench . -cpu 1 


在 执行 了 这 个 命令 之 后 ， 每 次 执行 TestGoPrint2 都 将 得 到 完全 相 
同 的 结 








9.2.2 ”goroutine 与 性 能 





在 了 解 了 goroutine 的 运作 方式 之 后 ， 接 下 来 我 们 要 考虑 的 就 是 如 何 
通过 goroutine 来 提高 性 能 。 本 节 在 进行 性 能 测试 时 将 治 用 上 一 节 定 义 的 


printl . goPrint1 每 函数 ， 但 为 了 避免 这 些 函 数 在 并 发 执行 时 输出 一 
些 乱 粳 粳 的 结果 ， 这 次 我 们 将 把 代码 中 的 fnt Println 语句 注释 掉 。 
代码 清单 9-4 展 示 了 为 print1 函数 和 goPrint1 函数 设置 的 基准 测试 用 
例 ， 这 些 用 例 定 义 在 goroutine_ test.go 文 件 中 。 

















代码 清单 9-4 ”为 无 goroutine 和 有 goroutine 的 函数 分 别 创建 基准 测试 用 例 











func BenchmarkPrint1(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
print1() 
} 
} 


func BenchmarkGoPrinti(b *testing.B) { @ 
for i := @; i < b.N; i++ { 
goPrint1() 
} 
} 








@ 对 顺序 执行 的 函数 进行 基准 测试 
© 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 


在 使 用 以 下 命令 进行 性 能 基准 测试 并 跳 过 功能 测试 之 后 : 


go test -run x -bench . -cpu 1 


我 们 将 看 到 以 下 结 


BenchmarkPrint1 100000000 13.9 ns/op 
BenchmarkGoPrint1 1000000 1090 ns/op 











(运行 这 个 测试 只 使 用 了 单个 CPPU， 具 体 原因 本 章 稍 后 将 会 说 
到 。) 正如 结果 所 示 ， 函 数 print1 运行 得 非常 快 ， 只 使 用 了 13.9 ns。 
令 人 感到 惊讶 的 是 ， 在 使 用 goroutine 运 行 相同 函数 时 ， 程 序 的 速度 居然 
慢 了 如 此 之 多 ， 足 足 耗费 了 1090 ns! 出 现 这 种 情况 的 原因 在 于 “天 下 没 
有 免费 的 午餐 ”: 无论 goroutine 有 多 么 的 轻 量 级 ， 启 动 goroutine 还 是 有 
一 定 的 代价 的 。 因 为 printNumbers1 函数 和 printLetters1 函数 是 如 
此 简单 ， 它 们 执行 的 速度 是 如 此 快 ， 所 以 以 goroutine 方 式 执 行 它 们 反而 
会 比 顺序 执行 的 代价 更 大 。 





如 果 我 们 对 每 次 迭代 都 带 有 一 定 延 人 运 的 printNumbers2 函数 和 
printLetters2 函数 执行 类 似 的 测试 ， 结 果 又 会 如 何 呢 ?代码 清单 9-5 
展示 了 goroutine_test .go 文件 中 为 以 上 两 个 函数 设置 的 基准 测试 用 
例 。 























代码 清单 9-5 ”为 无 goroutine 和 有 goroutine 的 带 延 迟 函数 分 别 创 建 基准 测试 用 例 








func BenchmarkPrint2(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
print2() 


} 


func BenchmarkGoPrint2(b *testing.B) { @ 
for i := 0; i < b.N; i++ { 
goPrint2() 








@ 对 顺序 执行 的 函数 进行 基准 测试 


© 对 以 goroutine 形式 执行 的 函数 进行 基准 测试 


在 运行 这 一 基准 测试 之 后 ， 我 们 将 得 到 以 下 结果 : 


BenchmarkPrint2 10000 121384 ns/op 
BenchmarkGoPrint2 1000000 17206 ns/op 





这 次 的 测试 结果 跟 上 一 次 的 测试 结果 有 些 不 同 。 可 以 看 到 ， 以 
goroutine 方 式 执行 print Numbers2 和 printLetters2 的 速度 是 以 顺序 
方式 执行 这 两 个 函数 的 速度 的 差不多 7 倍 。 现 在 ， 让 我 们 把 函数 的 迭代 
次 数 从 10 次 改 为 100 次 ， 然 后 再 运行 相同 的 基准 测试 : 





func printNumbers2() { 
for i := 0; i < 100; i++ { @ 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%d ", i) 
} 
} 


func printLetters2() { 
for i := 'A'; i < 'A'+100; i++ { @ 
time.Sleep(1 * time.Microsecond) 
// fmt.Printf("%c ", i) 
} 
} 





@ 1440100 次 而 不 是 10 次 
© 1540100 次 而 不 是 10 次 


下 面 是 这 次 基准 测试 的 结果 : 





BenchmarkPrint1 20000000 86.7 ns/op 
BenchmarkGoPrint1 1000000 1177 ns/op 
BenchmarkPrint2 2000 1184572 ns/op 


BenchmarkGoPrint2 1000000 17564 ns/op 


pO 


在 这 次 基准 测试 中 ，print1 函数 的 基准 测试 时 间 是 之 前 的 13 倍 ， 
而 goPrint1 函数 的 速度 跟 上 一 次 相 比 没有 出 现 太 大 变化 。 另 一 方面 ， 
通过 延迟 模拟 负载 的 函数 的 测试 结果 变化 非常 之 大 一 一 以 顺序 方式 执行 
的 函数 和 以 goroutine 方 式 执行 的 函数 之 间 ， 两 者 的 执行 时 间 相 差 了 67 倍 
之 多 。 因 为 这 次 基准 测试 的 迭代 次 数 比 之 前 增加 了 10 倍 ， 所 以 print2 
函数 在 进行 基准 测试 时 的 速度 差不多 是 上 次 的 10， 但 对 于 goPrint2 
来 说 ， 和 迭代 10 次 所 需 的 时 间 跟 迭代 100 次 所 需 的 时 间 却 几乎 是 相同 的 。 








注意 ， 到 目前 为 止 ， 我们 部 是 在 用 一 个 CPU 执 行 测 试 ， 但 如 果 我 们 
执行 以 下 命令 ， 改 用 两 个 CPU 执 行 带 有 100 次 迭代 的 基准 测试 : 


go test -run x -bench . -cpu 2 


那么 我 们 将 得 到 以 下 结果 : 


BenchmarkPrint1-2 20000000 87.3 ns/op 
BenchmarkGoPrint2-2 5000000 391 ns/op 
BenchmarkPrint2-2 1000 1217151 ns/op 


BenchmarkGoPrint2-2 200000 8607 ns/op 








因为 print1 函数 以 顺序 方式 执行 ， 无 论 运行 时 环境 提供 多 少 个 
CPU， 它 都 只 能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 跟 上 一 次 的 测试 
结果 基本 相同 。 与 此 相反 ，goPrint1 函数 这 次 因为 使 用 了 两 个 CPU 来 
分 担 计 算 负 载 ， 所 以 它 的 性 能 提高 了 将 近 3 倍 。 此 外 ， 因 为 print2 也 只 

能 使 用 一 个 CPU， 所 以 它 这 次 的 测试 结果 也 跟 预料 中 的 一 样 ， 并 没有 发 





生 什 么 变化 。 最 后 ， 因 为 goPrint2 使 用 了 两 个 CPU 来 分 担 计算 负载 ， 
所 以 它 这 次 的 测试 比 之 前 快 了 两 倍 。 

现在 ， 如 果 我 们 更 进一步 ， 使 用 4 个 CPU 来 运行 相同 的 基准 测试 ， 
结果 将 会 如 何 ? 


BenchmarkPrint1-4 20000000 90.6 ns/op 
BenchmarkGoPrint1-4 3000000 479 ns/op 
BenchmarkPrint2-4 1000 1272672 ns/op 


BenchmarkGoPrint2-4 300000 6193 ns/op 





正如 我 们 预期 的 那样 ，print1 函数 和 print2 函数 的 测试 结果 还 是 
一 如 既往 地 没有 发 生 什 么 变化 。 但 令 人 惊奇 的 是 ， 尽 管 goPrint1 在 使 
用 4 个 CPU 时 的 测试 结果 还 是 比 只 使 用 一 个 CPU 时 的 测试 结果 要 好 ， 但 
使 用 4 个 CPU 的 执行 速度 居然 比 使 用 两 个 CPU 的 执行 速度 要 慢 。 与 此 同 
时 ， 虽 然 只 有 40% 的 提升 ， 但 goPrint2 在 使 用 4 个 CPU 时 的 成 绩 还 是 比 
使 用 2 个 CPU 时 的 成 绩 要 好 。 使 用 更 多 CPU 并 没有 市 来 性 能 提升 反而 导 
致 性 能 下 降 的 原因 跟 之 前 提 到 的 一 样 : 在 多 个 CPU 上 调度 和 运行 任务 需 
要 耗费 一 定 的 资源 ， 如 果 使 用 多 个 CPU 带 来 的 性 能 优势 不 足以 抵消 随 之 
而 来 的 额外 消耗 ， 那 么 程序 的 性 能 就 会 不 升 反 降 。 











升 ， 更 重要 的 是 要 理解 代码 ， 并 对 其 进行 基准 测试 ， 以 了 解 它 的 性 能 特 
质 。 


9.2.3 ”等 待 goroutine 


在 上 一 节 中 ， 我 们 了 解 到 程序 启动 的 goroutine 在 程序 结束 时 将 会 被 


粗暴 地 结束 ， 昌 然 通 过 sleep 函数 来 增加 时 间 延 迟 可 以 避免 这 一 问题 ， 
但 这 说 到 底 只 是 一 种 权宜 之 计 ， 并 没有 真正 地 解决 问题 。 里 然 在 实际 的 
代码 中 ， 程 序 本 身 比 goroutine 更 早 结束 的 情况 并 不 多 见 ， 但 为 了 避免 意 
外 ， 我 们 还 是 需要 有 一 种 机 制 ， 使 程序 可 以 在 确保 所有 goroutine 都 已 经 
执行 完毕 的 情况 下 ， 再 执行 下 一 项 工作 。 








为 此 ，Go 语 言 在 sync 包 中 提供 了 一 种 名 为 等 竺 组 (NaitGroup ) 
的 机 制 ， 它 的 运作 方式 非常 简单 直接 : 


。 声明 一 个 等 待 组 ; 

。 使 用 Add 方法 为 等 待 组 的 计数 器 设置 值 ; 

e 当 一 个 goroutine 完 成 它 的 工作 时 ， 使 用 Done 方法 对 等 符 组 的 计数 咒 
执行 减 一 操作 ; 

。 调用 Wait 方法 ， 该 方法 将 一 直 阻 塞 ， 直 到 等 竺 组 计数 器 的 值 变 为 
0。 


代码 清单 9-6 展 示 了 一 个 使 用 等 待 组 的 例子 ， 在 这 个 例子 中 ， 我 们 
复 用 了 之 前 展示 过 的 printNumbers2 函数 以 及 printLetters2 MA, 
并 为 它们 分 别 加 上 了 1lhs 的 延迟 。 





























代码 清单 9-6 ”使 用 等 待 组 








package main 


import "fmt" 
import "time" 
import "sync" 


func printNumbers2(wg *sync.WaitGroup) { 
for i := 0; i < 10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt .Printf("%d ", i) 


wg.Done() @ 


} 


func printLetters2(wg *sync.WaitGroup) { 
for i := 'A'; i < 'A'+10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt .Printf("%c ", i) 


wg.Done() @ 


} 


func main() { 
var wg sync.WaitGroup © 
wg.Add(2) @ 
go printNumbers2(&wg) 
go printLetters2(&wg) 
wg.Wait() © 





@ 对 计数 器 执行 减 一 操作 


O 对 计数 器 执行 减 一 操作 
@ 声明 一 个 等 待 组 
@ 为 计数 器 设置 什 
© 阻塞 到 计数 器 的 值 为 


如 果 我 们 运行 这 个 程序 ， 那 么 它 将 巧妙 地 打印 出 A1B2C3 
D4E5F66G67H8I9]。 这 个 程序 的 运作 原理 是 这 样 的 : CA 
先 定 义 一 个 名 为 wg 的 WaitGroup 变量 ， 然 后 通过 调用 wg 的 Add 方法 将 
计数 器 的 值 设 置 成 2; 在 此 之 后 ， 程 序 会 分 别 调用 printNumbers2 和 
printLetters2 这 两 个 goroutine， 而 这 两 个 goroutine 都 会 在 末尾 对 计数 


a ESAT Va — ERIE. Ja eres ved SZ Wait 方法 ， 并 因此 而 
被 阻塞 ， 这 一 状态 将 持续 到 两 个 goroutine 都 执行 完毕 并 调用 Done 方法 
为 止 。 当 程序 解除 阻塞 状态 之 后 ， 它 就 会 跟 平常 一 样 ， 目 然 地 结束 。 


如 果 我 们 在 某 个 goroutine 里 面 筷 记 了 对 计数 器 执行 减 一 操作 ， 那 么 
等 竺 组 将 一 直 阻 塞 ， 直 到 运行 时 环境 发 现 所 有 goroutine 都 已 经 休眠 为 
止 ， 这 时 程序 将 引发 一 个 panic: 











0A1B2C3D4E5F66G7H8 I 9J fatal error: all goroutines are as 


leep - deadlock! 





SX REAM fl A, ELA, ERTS ASR le AS 
可 或 缺 的 工具 。 


9.3 ”通道 


在 前 一 节 ， 我 们 学 习 了 如 何 通过 go 关键 字 ， 把 普通 函数 转换 为 
goroutine 以 便 让 其 独立 运行 ， 并 在 9.2.2 节 学 习 了 如 何 通过 等 待 组 来 同步 
独立 运行 的 多 个 goroutine。 在 这 一 节 ， 我 们 将 要 学 习 的 是 ， 如 何 使 用 通 
道 在 多 个 不 同 的 goroutine 之 间 通 信 。 


通道 就 像 是 一 个 箱子 ， 不 同 的 goroutine 可 以 通过 这 个 箱子 与 其 他 
goroutine 通 信 : 如 果 一 个 goroutine 想 要 把 一 项 信息 传递 给 另 一 个 
goroutine， 那 么 它 就 必须 把 该 信息 放置 到 箱子 里 ， 然 后 男 一 个 goroutine 
则 负责 从 箱子 里 取出 被 放置 的 信息 ， 束 像 图 9-3 所 示 的 那样 。 


发 送 者 接收 者 


goroutine goroutine 





Go 的 无 缓冲 通道 


图 9-3 ”把 Go 的 无 缓冲 通道 看 作 是 一 个 箱子 





通道 (channel) 是 一 种 禹 有 类 型 的 值 (typed value) ， 它 可 以 让 不 


同 的 goroutine 互 相通 信 。 通 道 用 make 函数 创建 ， 该 函数 在 被 调用 之 后 
将 返回 一 个 指向 底层 数据 结构 的 引用 作为 结果 值 。 比 如 ， 以 下 代码 就 展 
示 了 如 何 创建 一 个 由 整数 组 成 的 通道 : 


ch := make(chan int) 


make 六 数 默认 创建 的 都 是 无 缓冲 通道 Cunbuffered channel) ， 如 果 
用 户 在 创建 通道 时 ， 同 make 函数 提供 了 可 选 的 第 三 个 整数 参数 ， 那 
么 make 函数 将 创建 出 一 个 市 有 给 定 大 小 的 有 绥 冲 通道 (buffered 
channel)。 比 如 说 ， 以 下 代码 就 会 创建 出 一 个 大 小 为 10 的 整数 有 绥 冲 通 


道 
ch := make(chan int, 10) 


无 缓冲 通道 是 同步 的 ， 它 就 像 是 一 个 每 次 只 能 容纳 一 件 物体 的 箱 
F: 当 一 个 goroutine 把 一 项 信息 放 入 无 缓冲 通道 之 后 ， 除 非 有 某 个 
goroutine 把 这 项 信息 取 走 ， 人 否则 其 他 goroutine 将 无 法 再 癌 这 个 通道 放 入 
任何 信息 。 这 也 意味 着 ， 如 果 一 个 goroutine 想 要 问 一 个 已 经 包含 了 某 项 
言 奶 的 无 绥 冲 通道 再 放 入 一 项 信息 ， 那 么 这 个 goroutine 将 被 阻塞 并 进入 
休眠 状态 ， 直 到 该 通道 变 空 为 止 。 











同样 地 ， 如 果 一 个 goroutine 演 试 从 一 个 并 没有 包含 任何 信息 的 无 组 
冲 通 道中 取出 一 项 信息 ， 那 么 这 个 goroutine 将 会 被 阻塞 并 进入 休眠 状 
态 ， 直 到 通道 不 再 为 空 为 止 。 


将 信息 放 入 通道 的 语法 是 非常 直观 的 ， 比 如 ， 通 过 执行 以 下 语句 ， 
我 们 可 以 把 数字 1 放 入 通道 ch 里 面 : 


ch <- 1 


从 通道 里 面 取出 信息 的 语法 同样 非常 直观 ， 比 如 ， 通 过 执行 以 下 语 
句 ， 我 们 可 以 从 通道 ch 里 面 移 除 一 个 值 ， 并 将 该 值 赋值 给 变量 i : 








i := <- ch 


通道 可 以 是 定向 的 (directional)。 在 默认 情况 下 ， 通 道 将 以 双向 
的 (bidirectional〉 形 式 运作 ， 用 户 既 可 以 把 值 放 入 通道 ， 也 可 以 从 通 
道 取 出 值 ， 但 是 ， 通 道 也 可 以 被 限制 为 只 能 执行 发 送 操作 (send-only) 
或 者 只 能 执行 接收 操作 (receive-only) 。 比 如 ， 以 下 语句 就 展示 了 如 
何 创建 一 个 只 能 执行 发 送 操作 的 字符 串通 道 : 





ch := make(chan <- string) 








而 以 下 语句 则 展示 了 如 何 创建 一 个 只 能 执行 接收 操作 的 字符 串通 道 


ch := make(<-chan string) 


用 户 除了 可 以 直接 创建 定 疝 的 通道 之 外 ， 还 可 以 把 一 个 双 癌 通道 转 
变 为 定 问 通道 ， 我 们 将 会 在 本 革 的 末尾 看 到 一 个 这 样 的 例子 。 


9.3.1 通过 通道 实现 同步 


也 许 你 已 经 猜 到 了 ， 通 道 非常 适用 于 对 两 个 goroutine 进 行 同步 ， 当 
一 个 goroutine 需 要 依赖 男 一 个 goroutine 时 ， 更 是 如 此 。 事 不 宜人 壕 ， 让 我 
们 马上 来 看 看 代码 清单 9-7 所 示 的 程序 : 这 个 程序 沿用 了 上 一 节 展 示 过 
的 例子 ， 唯 一 的 不 同 在 于 ， 这 次 的 程序 使 用 了 通道 而 不 是 等 待 组 来 对 


goroutine 进 行 同步 。 

















代码 清单 9-7 使 用 通道 同步 goroutine 


package main 


import "fmt" 
import "time" 


func printNumbers2(w chan bool) { 
for i := 0; i < 10; i++ { 
time.Sleep(1 * time.Microsecond) 
fmt .Printf("%d ", i) 
} 
w <- true @ 
} eo 
func printLetters2(w chan bool) { @ 
for i := 'A'; i < 'A'+10; i++ { @ 


time.Sleep(1 * time.Microsecond) @ 
fmt.Printf("%c ", i) @ 


func main() { 
w1, w2 := make(chan bool), make(chan bool) 
go printNumbers2(w1) 
go printLetters2(w2) 
<-w1 @ 
<-w2 @ 





@ 把 一 个 布尔 值 放 入 通道 ， 以 便 解 除 主 程序 的 阻 竖 状态 
O 主 程序 将 一 直 阻 塞 ， 直 到 通道 里 面 出 现 可 弹出 的 值 为 止 


a a bb PRA. E EEEE ywi 和 w2 这 两 
个 bool 类 型 的 通道 ， 接 着 以 goroutine 方 式 运行 了 printNumbers2 函数 
e A 函数 ， 并 将 两 个 通道 分 别传 给 了 这 两 个 函数 。 在 启 
A main 函数 将 会 尝试 从 通道 w1 中 移 除 一 个 值 ， 但 
由 于 通道 w1 当时 并 没有 包含 任何 值 ， 所 以 main 函数 将 会 在 此 处 阻 窄 。 
当 printNumbers2 即将 执行 完毕 ， 并 将 一 个 true 值 放 入 通道 wl1 之 
Ja» main 函数 的 阻 奢 状态 才 会 被 解除 ， 并 继续 答 试 从 第 二 个 通道 w2 中 
弹出 一 个 值 。 跟 之 前 一 样 ， 在 printLetters2 M4 ae ne 值 放 
入 通道 w2 ZA, main 函数 将 一 直 阻 塞 ， 直 到 它 成 功 取得 了 wz2 通道 中 的 
true 值 之 后 ， 阻 压 才 会 解除 ， 然 后 main 函数 才 会 顺利 退出 。 





要 注意 的 是 ， 因 为 我 们 只 是 想 要 在 goroutine 执 行 完毕 之 后 解除 对 
main 函数 的 阻塞 ， 而 不 是 真正 地 想 要 使 用 通道 中 存储 的 值 ， 所 以 程序 
在 从 通道 w1 和 w2 里 面 取 出 值 之 后 并 没有 使 用 这 些 值 。 








代码 清单 9-7 展 示 的 是 一 个 非常 简单 的 例子 ， 这 个 例子 中 的 程序 使 
用 通道 只 是 为 了 对 多 个 goroutine 进 行 同步 ， 但 这 些 goroutine 之 间 并 没有 
通信 。 不 过 在 接 下 来 的 一 节 ， 我 们 就 会 看 到 一 个 在 多 个 goroutine 之 则 传 
递 消息 的 例子 。 








9.3.2 ”通过 通道 实现 消息 传递 


代码 清单 9-8 展 示 了 两 个 以 goroutine 形 式 独 立 运行 的 函数 ， 其 中 一 个 


函数 是 投掷 器 (thrower) ， 它 接受 一 个 通道 作为 参数 ， 然 后 一 个 接 一 个 
地 把 一 组 数字 发 送 到 通道 里 ， 而 另 一 个 函数 则 是 捕捉 器 (catcher) ， 它 
会 从 相同 的 通道 里 一 个 接 一 个 地 取出 一 组 数字 ， 并 把 这 些 数字 打印 出 
We 




















代码 清单 9-8 ”使 用 通道 实现 消息 传递 

















package main 


import ( 
n" fmt "n" 
"time " 


) 


func thrower(c chan int) { 
for i := @; i < 5; i++ { 
c<- ie 
fmt.Println("Threw >>", i) 
} 
} 


func catcher(c chan int) { 
for i := @; i < 5; i++ { 
num := <-c @ 
fmt.Println("Caught <<", num) 


} 
} 


func main() { 
c := make(chan int) 
go thrower(c) 
go catcher(c) 
time.Sleep(100 * time.Millisecond) 


} 





@ 把 数字 值 推 入 通道 中 


O 从 通道 中 取出 数字 值 


运行 这 个 程序 将 得 到 以 下 结果 : 


Caught << 6 


Threw >> @ 
Threw >> 1 
Caught << 1 
Caught << 2 
Threw >> 2 
Threw >> 3 
Caught << 3 
Caught << 4 
Threw >> 4 





在 这 段 输出 结果 中 ， 某 些 Caught 语句 出 现在 了 Threw 语句 的 前 
面 ， 但 这 并 不 意味 着 程序 的 运行 出 现 了 错误 一 一 之 所 以 会 出 现 这 样 的 乱 
象 ， 仪 仪 是 因为 运行 时 环境 在 向 通道 推 入 值 或 者 从 通道 中 取出 值 之 后 ， 
调度 到 了 打印 语句 所 致 。 最 重要 的 是 ， 打 印 语句 中 出 现 的 数字 都 是 有 序 
的 ， 这 意味 着 投掷 喜 在 回 通 道 “ 投 掷 ” 一 个 数字 之 后 ， 捕 捉 器 必须 先 “ 捕 
捉 ” 这 个 数字 ， 然 后 才能 处 理 下 一 个 数字 。 














9.3.3 “有 缓冲 通道 


无 缓冲 通道 或 者 说 同步 通道 Csynchronous channel) 使 用 起 来 非常 
简单 ， 而 与 之 相对 的 有 缓冲 通道 则 更 复杂 一 些 ， 后 者 是 一 种 异步 的 、 先 
进 先 出 消息 队列 。 如 图 9-4 所 示 ， 有 缓冲 通道 就 像 是 一 个 能 够 容纳 多 个 
同类 信息 的 大 箱子 : 一 个 goroutine 可 以 持续 地 回 箱 子 里 面 推 入 信息 ， 并 
且 在 箱子 被 填 满 之 前 ， 推 入 信息 的 goroutine 都 不 会 被 阻塞 ， 同 样 地 ， 一 
个 goroutine 可 以 按照 信息 被 推 入 的 顺序 ， 持 续 地 从 箱子 里 取出 信息 ， 并 
且 在 箱子 被 掏 空 之 前 ， 取 出 信息 的 goroutine 都 不 会 被 阻塞 。 





道 
道 








发 送 者 接收 者 
goroutine goroutine 






Go 的 有 缓冲 通道 


图 9-4 将 Go 的 有 缓冲 通道 看 作 是 一 个 箱子 











接 下 来 ， 就 让 我 们 看 看 有 绥 冲 通道 在 投掷 右 和 捕 欣 器 的 例子 中 是 如 
何 运作 的 。 为 此 ， 我 们 需要 对 代码 清单 9-8 中 ， 以 下 这 个 创建 无 缓冲 通 
道 的 语句 进行 修改 : 


c := make(chan int) 


证 筷 转 而 创建 一 个 大 小 为 3 的 有 缓冲 通道 : 


c := make(chan int, 3) 











6 
1 
2 
6 
Caught << 1 
2 
3 
4 
3 


Caught << 4 


Ni hai RADE BY, Boast — AAAS, EPI 
Sepa HAS LBA Se ALE, mA dae ie We RIT MAE E H E HEA A BL 
字 。 如 采 你 在 解决 东 个 问题 的 时 候 ， 只 有 有 限 数量 的 工作 进程 可 用 ， 并 
且 你 打算 限制 传 入 请 求 的 数量 ， 那 么 有 缓冲 通道 将 是 一 种 非常 合适 的 工 
具 


FNO 


9.3.4 ”从 多 个 通道 中 选择 


Go 拥有 一 个 特殊 的 关键 字 select ， 它 允许 用 户 从 多 个 通道 中 选择 
一 个 通道 来 执行 接收 或 者 发 送 操作 。select 关键 字 就 像 是 专门 为 通道 
而 设 的 switch 语句 ， 代 码 清单 9-9 展 示 了 一 个 使 用 select 关键 字 的 例 
Ts 











代码 清单 9-9 ”从 多 个 通道 中 选择 














package main 


import ( 
"fmt" 
) 


func callerA(c chan string) { 
c <- “Hello World!" 


} 


func callerB(c chan string) { 
c <- “Hola Mundo!" 


} 


func main() { 
a, b := make(chan string), make(chan string) 
go callerA(a) 
go callerB(b) 


for i := @; i < 5; i++ { 
select { 
case msg := <-a: 
fmt.Printf("%s from A\n", msg) 
case msg := <-b: 
fmt.Printf("%s from B\n", msg) 





这 个 程序 中 的 callerA 和 callerB 两 个 函数 都 会 接受 一 个 字符 串通 
道 作为 参数 ， 并 向 该 通道 发 送信 息 。 在 以 goroutine 方 式 调用 callerA 和 
callerB 之 后 ， 程 序 会 进行 5 次 迭代 《次 数 的 多 少 无 关 紧 要 ，5 是 一 个 随 
意 选 取 的 数字 ) ， 并 且 在 每 次 迭 代 中 ，Go 的 运行 时 环境 都 会 根据 通道 a 











或 者 通道 b 是 否 有 值 来 决定 应 该 对 哪个 通道 执行 取 值 操作 。 如 采 两 个 通 
道 都 有 值 ， 那 么 Go 运行 环境 将 随机 选择 其 中 一 个 通道 。 

我 们 的 计划 听 上 去 似乎 完美 无 瑕 ， 但 是 在 实际 运行 程序 的 时 候 ， 
Go 却 癌 我 们 报告 了 一 个 死 锁 错误 : 


Hello World! from A 
Hola Mundo! from B 


fatal error: all goroutines are asleep - deadlock! 





出 现 这 个 错误 的 原因 我 们 前 面 已 经 提 到 过 了 ， 当 一 个 goroutine 取 出 
无 缓冲 通道 中 唯一 的 值 之 后 ， 无 缓冲 通道 将 变 为 空 ， 之 后 任何 答 试 从 罕 
通道 获取 值 的 goroutine 都 会 被 阻塞 并 进入 休眠 状态 。 在 这 个 例子 
H, main 函数 首先 在 第 一 次 达 代 中 从 通道 a 里 取出 了 值 ， 并 导致 通道 a 
AA; 接着 叉 在 第 二 次 迭代 中 从 通道 b 里 取出 了 值 ， 并 导致 通道 b 为 





空 ， 然 后 在 进行 第 三 次 迭代 时 ，main 函数 发 现 通 道 a 和 通道 b 都 为 空 ， 
于 是 它 就 会 被 阻塞 并 进入 休眠 ， 但 由 于 这 时 callerA 和 callerB 这 两 个 
goroutine 都 已 执行 完毕 ， 所 以 通道 a 和 通道 b 将 永远 也 不 会 再 有 值 ， 

而 main 函数 也 只 能 永远 等 竺 下 去 一 一 在 检测 到 这 一 情况 之 后 ，Go 运 行 
时 环境 抛 出 了 和 死 锁 错误 。 


解决 这 个 问题 并 不 困难 ， 我 们 只 需要 为 select 语句 谎 加 一 个 默认 
分 文 ， 让 select 语句 在 所 有 可 选 通道 都 已 被 阻塞 的 情况 下 执行 验 认 分 
支 即 可 ， 以 下 代码 中 加 粗 的 部 分 就 是 新 添加 的 默认 分 文 : 


select { 
case msg := < -a: 
fmt.Printf("%s from A\n", msg) 
case msg := < -b: 

fmt.Printf("%s from B\n", msg) 
default: 


fmt.Printlin( "Default" ) 





“select 语句 没有 发 现任 何 可 用 的 通道 时 ， 它 就 会 执行 默认 分 文 
中 的 代码 。 对 于 上 面 的 例子 来 说 ， 当 存储 在 通道 3 和 通道 b 里 面 的 值 都 
被 取出 之 后 ， 程 序 就 会 在 下 一 次 迭代 中 执行 默认 分 文中 的 代码 。 但 是 ， 
如 果 现 在 就 执行 这 段 代码 ， 就 只 会 看 到 默认 分 支 打 印 的 输出 : 这 是 因为 
程序 太 早 就 调用 select 语句 了 ， 以 至 于 通道 a 和 通道 b 还 没 来 得 及 接受 
callerA 和 callerB 发 送 给 它们 的 值 ，select 语句 就 跳 过 两 个 还 没有 





值 的 通道 直接 执行 默认 分 文 了 。 为 了 让 这 个 程序 能 够 正确 工作 ， 我 们 需 
要 在 每 次 碗 代 之 前 添加 1s 的 延 运 ， 从 而 使 通道 能 够 正常 接收 goroutine 发 
送 给 它们 的 值 ， 以 下 代码 中 加 粗 显 示 的 就 是 新 添加 的 语句 : 





for i := @; i < 5; i++ { 
time.Sleep(1 * time.Microsecond) 


select { 
case msg := < -a: 

fmt.Printf("%s from A\n", msg) 
case msg := < -b: 

fmt.Printf("%s from B\n", msg) 
default: 

fmt .Println( "Default" ) 





运行 这 个 修改 后 的 程序 ， 死 锁 将 不 会 再 出 现 : 


Hello World! from A 
Hola Mundo! from B 
Default 


Default 
Default 











从 程序 输出 的 结果 可 以 看 到 ， 在 通道 a 和 通道 b 包含 的 值 都 被 取出 
E E 


在 循环 里 添加 延迟 时 间 的 做 法 初 看 上 去 会 让 人 感觉 有 些 奇 怪 ， 但 这 
其 实 只 是 为 了 展示 select 语句 的 用 法 而 想 出 来 的 权宜 之 计 。 在 实际 





中 ， 大 部 分 情况 下 用 户 使 用 的 都 是 无 限 循环 ， 而 不 是 有 限 次 数 的 达 代 ， 
这 时 程序 的 处 理 方式 就 会 有 所 不 同 。 比 如 ， 如 果 我 们 是 在 一 个 无 限 循环 
中 使 用 select 语句 ， 那 么 在 所 有 通道 都 为 空 之 后 ， 程 序 将 无 限 次 执行 
默认 分 文 ， 这 时 我 们 就 可 以 对 默认 分 文 的 执行 次 数 进行 计数 ， 并 在 计数 
到 达 指 定 限 制 时 退出 循环 。 











其 实在 实际 中 ， 我 们 并 不 需要 像 上 面 所 说 的 那样 ， 通 过 计数 器 来 退 
出 带 有 select 语句 的 无 限 循 环 ， 和 函数 来 关 
闭 通 道 能 够 更 好 地 达到 这 一 目的 : 使 用 close 函数 关闭 通道 ， 相 当 于 向 

道 的 接收 者 表明 该 通道 将 不 会 再 收 到 任何 值 。 eens nies 
oo 党 试 向 一 个 已 关闭 的 通道 发 送信 息 将 会 引发 一 个 panic， 
尝试 关闭 一 个 已 经 被 关闭 的 通道 也 是 如 此 。 尝 试 从 一 个 已 关闭 的 通道 取 
值 总 是 会 得 到 一 个 与 通道 类 型 相对 应 的 零 值 ， 因 此 从 已 关闭 的 通道 取 值 
并 不 会 导致 goroutine 被 阻塞 。 




















代码 清单 910 展 示 了 一 个 例子 ， 在 这 个 例子 中 ， 我 们 将 会 看 到 关闭 
道 的 方法 以 及 被 关闭 通道 是 如 何 帮助 程序 跳出 无 限 循环 的 。 





代码 清单 9-10 关闭 通道 



































package main 


import ( 
ill fmt n" 
) 


func callerA(c chan string) { 
c <- “Hello World!" 
close(c) @ 


}eo 


func callerB(c chan string) { @ 
c <- "Hola Mundo!" @ 


close(c) @ 


func main() { 
a, b := make(chan string), make(chan string) 
go callerA(a) 
go callerB(b) 
var msg string 


ok1, ok2 := true, true 
for ok1 || ok2 { 
select { 
case msg, oki = <-a: @ 
if oki { @ 
fmt.Printf("%s from A\n", msg) @ 
}@ 
case msg, ok2 = <-b: @ 
if ok2 { @ 
fmt.Printf("%s from B\n", msg) 
} 
} 
} 
} 





O 在 函数 被 调用 之 后 关闭 通道 


O 在 通道 被 关闭 之 后 ， 变 量 ok1 和 ok2 的 值 将 被 设置 为 false 


这 个 新 程序 不 再 只 达 代 5 次 ， 并 且 它 也 不 需要 在 碗 代 之 前 添加 时 间 
延迟 。 在 将 一 个 字符 串 发 送 至 通道 之 后 ， 程 序 调用 内 置 的 close 函数 天 
闭 了 该 通道 。 需 要 注意 的 是 ， 跟 关闭 文件 或 者 关闭 套 接 字 不 一 样 ， 关 闭 
通道 并 不 会 导致 通道 的 机 能 完全 停止 一 一 它 的 作用 就 是 通知 其 他 正在 尝 
试 从 这 个 通道 接收 值 的 goroutine， 这 个 通道 已 经 不 会 再 接收 到 任何 值 


to 
另外 需要 注意 的 是 ， 程 序 在 从 通道 里 面 取 值 时 ， 使 用 的 是 多 值 格式 














(multivalue form) : 


case value, ok1 = <-a 


在 执行 这 条 语句 时 ， 从 通道 a 里 面 取出 的 值 将 被 赋值 给 变量 value 
， 而 变量 ok1 则 会 被 设置 为 用 于 表示 通道 是 否 仍然 处 于 打开 状态 的 布尔 
值 。 如 果 通 道 已 被 关闭 ， 那 么 ok1 的 值 将 被 设置 为 false 。 











对 于 关闭 通道 我 们 需要 知道 的 最 后 一 点 束 是 ， 关 闭 通道 并 不 是 必 需 
的 。 正 如 之 前 所 说 ， 关 闭 通 道 只 不 过 是 在 告知 接收 者 该 通道 不 会 再 接收 
到 任何 值 而 已 。 在 代码 清单 9-10 剩 余 的 代码 中 ， 程 序 将 通过 检测 语句 来 
判断 通道 是 否 已 被 关闭 ， 并 在 通道 已 被 关闭 的 情况 下 ， 跳 出 循环 ， 不 再 
打印 任何 信息 。 下 面 是 执行 该 程序 得 出 的 结 


Hello World! from A 
Hola Mundo! from B 














9.4 在 Web 应 用 中 使 用 并 发 





直到 目前 为 止 ， 本章 都 是 在 独立 的 程序 中 展示 如 何 使 用 Go 的 并 发 
特性 ， 但 是 显然 地 ， 这 些 并 及 特性 不 仅 可 以 在 独立 的 程序 中 使 用 ， 还 可 
以 在 Web 应 用 中 使 用 。 在 这 一 节 中 ， 我 们 将 把 注意 力 放 到 Go Web 应 用 
上 ， 并 学 习 如 何 使 用 并 发 特性 去 提高 Go Web 应 用 的 性 能 。 我 们 不 仅 会 
使 用 前 面 己 经 介绍 过 的 一 些 基 础 技术 ， 而 且 还 会 了 解 一 些 出 现在 实际 
Web 应 用 中 的 并 发 模式 。 





在 本 他 中 ， 我 们 将 要 创建 一 个 对 图 片 进行 马赛 元 处 理 ， 以 此 来 生成 
马赛 元 图 片 的 Web 应 用 。 对 图 片 进 行 马 赛 元 (mosaic) 处 理 ， 指 的 是 将 
图 片 分 割 成 多 个 〈 通 利 是 大 小 相同 的 ) 矩形 截面 ， 然 后 使 用 一 些 被 称 状 
瓷砖 图 片 (tile picture) 的 新 疼 片 去 代 蔡 截面 原 有 的 图 乒 。 马 赛 殉 网 上 
的 奇妙 之 处 在 于 ， 如 果 人 们 从 足够 远 的 地 方 观察 ， 或 者 以 斜视 的 角度 观 
X, MSA SIA EET Bae EAE TE; FA, BORA 
ZMBASRAA, Me ROVE Ns HA ETRY BED A Bene 
图 片 组 成 。 


这 个 生成 马赛 克 图 片 的 Web 应 用 的 基本 想法 非常 简单 : 它 接收 用 户 
上 传 的 目标 图 片 (target picture〉， 然 后 据 此 生成 相应 的 马 才 元 图 片 。 
为 了 让 事情 保持 简单 ， 我 们 假设 总 砖 图 片 已 经 事先 准备 好 了 ， 并 且 它 们 
都 已 经 被 裁剪 到 了 合适 的 大 小 。 


9.4.1 创建 马赛 元 图 片 
创建 马赛 克 图 片 的 第 一 步 是 定义 一 个 马赛 克 算 法 ， 下 面 是 一 个 无 需 





使 用 任何 第 三 方 库 的 算法 步骤。 


(1) 通过 扫描 图 片 目录 ， 并 使 用 图 片 的 文件 名 作为 键 、 图 片 的 平 
均 颜 色 作为 值 ， 构 建 出 一 个 由 瓷砖 图 片 组 成 的 散 列 ， 也 就 是 一 个 瓷砖 图 
片 数 据 库 。 通 过 计算 图 片 中 每 个 像素 红 、 绿 、 蓝 3 种 颜色 的 总 和 ， 并 将 
它们 除 以 像素 的 总 数量 ， 我 们 就 得 到 了 一 个 三 元 组 ， 而 这 个 三 元 组 就 是 
图 片 的 平均 颜色 。 





(2) 根据 爸 砖 图 片 的 大 小 ， 将 目标 图 片 切 割 成 一 系列 尺寸 更 小 的 
子 图 片 。 


(3) 对 于 目标 图 片 切割 出 的 每 张 子 图片 ， 将 它们 位 于 左上 方 的 第 
一 个 像素 设 定 为 该 图 片 的 平均 颜色 。 


(4) 根据 子 图 片 的 平均 颜色 ， 在 瓷砖 图 片 数据 库 中 找 出 一 张 平 均 
颜色 与 之 最 为 接近 的 瓷砖 图 片 ， 然 后 在 目标 图 片 的 相应 位 置 上 使 用 瓷砖 
图 片 去 代 蔡 原 有 的 子 图 片 。 为 了 找 出 最 接近 的 平均 颜色 ， 程 序 需要 将 子 
图 片 的 平均 颜色 以 及 瓷砖 图 片 的 平均 颜色 都 转换 成 三 维 空间 中 的 一 个 
点 ， 并 计算 这 两 点 之 间 的 欧 几 里 得 距离 。 














G) 当 一 张 疾 砖 图 片 被 选中 之 后 ， 程 序 就 会 把 这 张 图 片 从 次 砖 图 
片 数据 库 中 移 除 ， 以 此 来 保证 马赛 克 图 片 中 的 每 张 瓷砖 图 片 都 是 独 一 无 
二 、 各 不 相同 的 。 








文件 mosaic.go 实现 了 上 述 的 马赛 元 算法 ， 我 们 接 下 来 将 逐一 分 析 
该 文件 包含 的 各 个 函数 。 首 先 ， 代 码 清单 9-11 展 示 了 该 文件 中 用 于 计算 
平均 颜色 的 averageColor 函数 。 


wy, 


9-11 averageColor 函数 























代码 清 


func averageColor(img image.Image) [3]float64 { 
bounds := img.Bounds() 
r, g, b := 0.0, 0.0, 0.0 
for y := bounds.Min.Y; y < bounds.Max.Y; y++ { 
for x := bounds.Min.X; x < bounds.Max.X; x++ { 
r1, g1, b1, _ := img.At(x, y).RGBA() 


r, g, b = r+float64(r1), g+float64(g1), b+float64(b1) @ 
} 


} 
totalPixels := float64(bounds.Max.X * bounds.Max.Y) 
return [3]float6é4{r / totalPixels, g / totalPixels, b / totalPixels} 


} 





@ 计算 出 给 定 图 片 的 平均 颜色 


averageColor 函数 会 把 给 定 图 乒 的 每 个 像素 中 的 红 、 绿 、 鉴 3 种 
颜色 相 加 起 来 ， 并 将 这 些 颜 色 的 总 和 除 以 图 片 的 像素 数量 ， 最 后 把 除法 
计算 的 结果 记录 在 一 个 新 创建 的 三 元 组 里 面 〈 这 个 三 元 组 使 用 包含 3 个 
元 素 的 数组 表示 ) 。 





之 后 ， 程 序 会 使 用 代码 清单 9-12 所 示 的 resize 函数 ， 把 图 片 缩 放 
FJR KE AY it BE 














代码 清单 9-12 resize 函数 

















func resize(in image.Image, newWidth int) image.NRGBA { @ 

bounds := in.Bounds() 

ratio := bounds.Dx()/ newWidth 

out := image.NewNRGBA(image.Rect(bounds.Min.X/ratio, bounds.Min.X/ratio, 
bounds .Max.X/ratio, bounds.Max.Y/ratio) ) 

for y, j := bounds.Min.Y, bounds.Min.Y; y < bounds.Max.Y; y, j = ytratio 


3 
j+1 { 
for x, i := bounds.Min.X, bounds.Min.X; x < bounds.Max.X; x, i = 
æx+ratio, i+1 { 


r, g, b, a := in.At(x, y).RGBA() 
out.SetNRGBA(i, j, color.NRGBA{uint8(r>>8), uint8(g>>8), uint8(b>>8) 


= uint8(a>>8)}) 


} 
} 


return *out 


} 





@ 将 给 定 图 片 缩放 至 指定 宽度 


代码 清单 9-13 展 示 了 tilesDB 函数 ， 这 个 函数 会 通过 扫描 瓷砖 图 片 
所 在 的 目录 来 创建 一 个 瓷砖 图 片 数 据 库 。 




















代码 清单 9-13 tilesDB 函数 





func tilesDB() map[string][3]float64 { @ 
fmt.Println("Start populating tiles db ...") 
db := make(map[string][3]float64) 
files, _ := ioutil.ReadDir("tiles") 
for _, f := range files { 
name := "tiles/" + £.Name() 
file, err := os.Open(name) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 
db[name] = averageColor(img) 
} else { 
fmt.Println("error in populating TILEDB:", err, name) 


} 
} else { 
fmt.Println("cannot open file", name, err) 


} 
file.Close() 


} 
fmt.Println("Finished populating tiles db.") 


return db 


} 





四 在 内 存 中 创建 一 个 瓷砖 图 片 数 据 库 


瓷砖 图 片 数据 库 是 一 个 映射 ， 这 个 映射 的 键 为 字符 串 ， 而 值 则 为 三 
元 组 〈 在 程序 中 使 用 包含 3 个 元 素 的 数组 来 表示 ) 。tilesDB 函数 会 打 
开 目 录 中 的 每 张 图 片 ， 并 根据 这 些 图 片 的 平均 颜色 在 映射 中 创建 相应 的 
记录 。 为 了 寻找 与 目标 图 片 相 匹配 的 瓷砖 图 片 ， 程 序 会 将 tilesDB 函数 
创建 的 瓷砖 图 片 数据 库 以 及 目标 图 片 的 平均 颜色 传 入 nearest 函数 。 





func nearest(target [3]float64, db *map[string][3]float64) string { ©@ 
var filename string 
smallest := 1000000.0 
for k, v := range *db { 
dist := distance(target, v) 
if dist < smallest { 
filename, smallest = k, dist 


} 
delete(*db, filename) 
return filename 


} 





@ 寻找 与 目标 图 片 平均 颜色 最 接近 的 瓷砖 图 片 








nearest 函数 会 把 瓷砖 图 片 数 据 库 中 的 所 有 记录 与 目标 图 片 的 平均 
颜色 一 一 进行 对 比 ， 而 两 者 欧 几 里 得 距离 最 短 的 那 一 条 记录 ， 就 是 与 目 
标 图 片 平 均 颜 色 最 为 接近 的 瓷砖 图 片 。 函 数 会 从 数据 库 中 移 除 被 选中 的 
瓷砖 图 片 ， 并 把 该 图 片 的 名 字 返 回 给 调用 者 。 代 码 清单 9-14 展 示 了 用 于 
计算 两 个 三 元 组 之 间 的 欧 几 里 得 距离 的 distance K% 























代码 清单 9-14 distance MA 


func distance(p1 [3]float64, p2 [3]float64) float64 { @ 
return math.Sqrt(sq(p2[@]-p1[@]) + sq(p2[1]-p1[1]) + sq(p2[2]-p1[2])) 








} 
func sq(n float64) float64 { @ 
return n * n 


} 





@ 计算 两 点 之 间 的 欧 几 里 得 距离 


O 计算 给 定数 值 的 平方 








因为 扫描 和 载 入 侈 砖 图 片 数据 库 是 一 项 非常 花 时 间 的 操作 ， 所 以 为 
了 效率 起 见 ， 比 起 每 次 生成 马赛 死 图 片 的 时 候 都 重复 一 壳 这 个 操作 ， 更 
合理 的 做 法 是 只 执行 一 次 这 个 操作 ， 创 建 出 一 个 瓷砖 图 片 数 据 库 的 原本 
Csource) ， 然 后 在 每 次 生成 马赛 元 图 片 的 时 候 都 根据 这 个 原本 复制 出 
一 个 独立 的 副本 《clone) 。 代 码 清单 9-15 展 示 了 作为 瓷砖 图 片 数据 库 的 
原本 而 存在 的 TILEDB 全 局 变量 ，Web 应 用 在 启动 的 时 候 束 会 创建 并 填 
WATE 

















代码 清单 9-15 cloneTilesDB 函数 














var TILESDB map[string][3]float64 


func cloneTilesDB() map[string][3]float64 { @ 
db := make(map[string][3]float64) 
for k, v := range TILESDB { 
db[k] = v 


return db 





O 每 次 需要 生成 马赛 殉 图 片 的 时 候 ， 就 复制 出 一 个 瓷砖 图 片 数据 
库 副本 


9.4.2 44850 Fh Webi H 


在 实现 了 马赛 克 生 成 函数 之 后 ， 我 们 接 下 来 就 可 以 实现 与 之 相对 应 
的 Web 应 用 了 。 代 码 清单 9-16 展 示 了 这 个 应 用 的 具体 代码 ， 这 些 代码 放 
在 了 main.go 文件 中 。 














代码 清单 9-16 “马赛克 图 片 Web 应 用 








package main 


import ( 
"bytes" 
"encoding/base64" 
"fmt" 
"html/template" 
"image" 
"image/draw" 
"image/jpeg" 
"net/http" 
"os" 
"strconv" 
"sync" 
"time" 


) 


func main() { 
mux := http.NewServeMux() 
files := http.FileServer(http.Dir("public")) 
mux.Handle("/static/", http.StripPrefix("/static/", files)) 
mux.HandleFunc("/", upload) 
mux.HandleFunc("/mosaic", mosaic) 


server := &http.Server{ 
Addr: "127.0.0.1:8080", 
Handler: mux, 

} 


TILESDB = tilesDB() 
fmt.Println("Mosaic server started.") 
server.ListenAndServe() 


} 


func upload(w http.ResponseWriter, r *http.Request) { 
t, _ := template.ParseFiles("upload.html") 


t.Execute(w, nil) 


} 


func mosaic(w http.ResponseWriter, r *http.Request) { 
tO := time.Now() 


r.ParseMultipartForm(10485760) 


file, _, _ := r.FormFile("image") @ 
defer file.Close() 
tileSize, _ := strconv.Atoi(r.FormValue("tile_size")) 
original, _, _ := image.Decode(file) @ 
bounds := original.Bounds() 
newimage := image.NewNRGBA(image.Rect(bounds.Min.X, bounds.Min.X, 


bounds .Max.X, bounds .Max.Y)) 


db := cloneTilesDB() © 

= image.Point{0, ©} @ 

for y := bounds.Min.Y; y < bounds.Max.Y; y = y + tileSize { © 
r x := bounds.Min.X; x < bounds.Max.X; x = x + tileSize { 


r, g, b, _ := original.At(x, y).RGBA() 
color := [3]float64{float64(r), float64(g), float64(b) } 


nearest := nearest(color, &db) 
file, err := os.Open(nearest) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 


t := resize(img, tileSize) 
tile := t.SubImage(t.Bounds() ) 
tileBounds := image.Rect(x, y, x+tileSize, y+tileSize) 
draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
} else { 
fmt.Printin("error:", err, nearest) 
} 
} else { 
fmt.Println("error:", nearest) 
} 
file.Close() 
} 
} 


buf1 := new(bytes.Buffer) 


jpeg.Encode(buf1, original, nil) © 
originalStr := base64.StdEncoding.EncodeToString(bufi1.Bytes() ) 


buf2 := new(bytes.Buffer) 
jpeg.Encode(buf2, newimage, nil) 
mosaic := base64.StdEncoding.EncodeToString(buf2.Bytes()) 
t1 := time.Now() 
images := map[string]|string{ 
"original": originalStr, 
"mosaic": mosaic, 
"duration": fmt.Sprintf("%v ", t1.Sub(t@)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 





@ 获取 用 户 上 传 的 目标 图 片 ， 以 及 瓷砖 图 片 的 尺寸 


@ 对 用 户 上 传 的 目标 图 片 进行 解码 

O 复制 瓷砖 图 数据 库 

O 为 每 张 侈 砖 图 片 设置 起 始点 

O 对 目标 图 片 分 割 出 的 每 张 子 图 进行 迭代 


O 将 图 片 编码 为 JPEG 格式 ， 然 后 通过 base64 字 符 串 将 其 传输 至 浏 


览 器 


mosaic 函数 是 一 个 处 理 器 函数 ， 在 这 个 函数 里 包含 了 用 于 生成 马 
赛 元 图片 的 主要 逻辑 首先， 程序 会 获取 用 户 上 传 的 目标 图 片 ， 并 从 表 
单 中 获取 瓷砖 图 片 的 尺寸 ， 接 着， 程序 会 对 目标 图 片 进行 解码 ， 并 创建 
出 一 张 全 新 的 、 衬 白 的 马赛 殉 图 片 ; 之 后 ， 程 序 会 复制 一 份 次 砖 图 片 数 
据 库 ， 并 为 每 张 次 砖 图 片 设置 起 始点 (source point) ， 而 这 一 起 始点 将 





在 稍 后 的 代码 中 个 image/draw 包 所 使 用 。 在 完成 了 上 述 的 准备 工作 之 
后 ， 程 序 吕 可 以 开始 对 目标 图 片 分 割 出 的 各 张 冤 砖 图 片 太 才 的 子 图 片 进 
{TIENT a 


对 于 每 张 被 分 割 的 子 图 片 ， 程 序 都 会 把 它 左 上 角 的 第 一 个 像素 设置 
为 该 图 片 的 平均 颜色 ， 然 后 在 疙 砖 图 片 数据 库 中 查找 与 该 颜色 最 为 接近 
的 侈 砖 图 片 。 在 找到 匹配 的 次 砖 图 片 之 后 ， 被 调用 的 函数 束 会 癌 程 序 返 
回 该 图 片 的 文件 名 ， 然 后 程序 束 可 以 打开 这 张 爹 砖 图 片 并 将 其 缩 放 人 至 指 
定 的 瓷砖 图 片 太 寸 了 。 在 缩放 操作 执行 完毕 之 后 ， 程 序 就 会 把 最 终 得 到 
的 总 砖 图 片 绘制 到 之 前 创建 的 马赛 克 图 片上 。 











在 使 用 上 述 方法 生成 出 整 张 马赛 苑 图片 之 后 ， 程 序 首 先 会 将 其 编码 
为 JPEG 格 式 的 图 片 ， 然 后 再 将 图 片 编码 为 base64 格 式 的 字符 串 。 


之 后 ， 程 序 会 将 用 户 上 传 的 目标 图 片 以 及 新 鲜 出 炉 的 马赛 区 图 片 都 
发 送 到 代码 清单 9-17 中 展示 的 results .html 模板 中 。 正 如 代码 清单 中 
加 粗 部 分 的 代码 所 示 ， 这 个 模板 会 通过 数据 URL 以 及 杏 入 Web 页 面 中 的 
base64 字 符 串 来 显示 被 传 入 的 两 张 图 片 。 注 意 ， 这 里 使 用 的 数据 URL 跟 
一 般 URL 的 作用 并 不 相同 ， 前 者 用 于 包含 给 定 的 数据 ， 而 后 者 则 用 于 指 
问 其 他 资源 。 
































代码 清单 9-17 ”用 于 展示 马赛 元 图 片 生 成 结果 的 模板 





< !DOCTYPE html> 
< html> 


< head> 
< meta http-equiv="Content-Type” content="text/html; charset=utf-8"> 
< title>Mosaic< /title> 

< /head> 

< body> 


< div class='container'> 
< div class="col-md-6"> 
< img src="data:image/jpg;base64,{{ .original }}" width="100%"> 


< div class="lead">Original< /div> 
< /div> 
< div class="col-md-6"> 
< img src="data:image/jpg;base64,{{ .mosaic }}" width="100%"> 


< div class="lead">Mosaic - {{ .duration }} 


< /div> 
< /div> 
< div class="col-md-12 center"> 
< a class="btn btn-lg btn-info" href="/">Go Back< /a> 
< /div> 
< /div> 
< br> 
< /body> 
< /html> 








假设 上 述 程序 位 于 mosaic 目录 当中 ， 那 么 我 们 可 以 在 构建 该 程序 
之 后 ， 通 过 执行 以 下 命令 ， 以 只 使 用 一 个 CPU 的 方式 去 运行 它 ， 并 得 到 
图 9-5 所 示 的 结 


GOMAXPROCS=1 ./mosaic 
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图 9-5 ”基本 的 马赛 克 图 片 生成 Web 应 用 
在 完成 了 基本 的 马赛 克 图 片 生成 Web 应 用 之 后 ， 我 们 接 下 来 要 考虑 
的 就 是 如 何 把 这 个 应 用 改造 成 相应 的 并 发 版 本 了 。 
9.43 ”并 发 版 马赛 元 图 片 生 成 Web 应 用 


并 发 的 一 个 常见 用 途 是 提高 性 能 。 上 一 节 展 示 的 Web 应 用 在 为 151 
KB 大 小 的 JPEG 图 片 创 建 马 赛 元 图 片 时 需要 耗费 2.25 s， 它 的 性 能 并 不 值 
得 称道 ， 但 我 们 可 以 通过 并 发 来 提高 它 的 性 能 。 具 体 来 说 ， 我 们 将 使 用 
以 下 算法 来 构建 一 个 并 发 版 本 的 马赛 克 图 片 生成 Web 应 用 : 


D 将 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 ; 


(2) 同时 对 被 分 割 的 4 张 子 图 片 进行 马赛 元 处 理 ; 
(3) 将 处 理 完 的 4 张 子 图 片 重新 合并 为 1 张 马赛 元 图 片 。 


图 9-6 以 图 示 的 方式 描述 了 上 述 步 又 。 


2. 分 别 对 4 张 子 图 片 
进行 马赛 到 处 理 。 


1. 将 目标 图 片 


aud 完 的 4 
分 割 为 4 等 份 。 将 处 理 完 的 4 张 子 图 片 


合并 为 1 张 马赛 克 图 片 。 





图 9-6 能够 更 快 地 生成 马赛 克 图 片 的 并 发 算法 


需要 注意 的 是 ， 这 个 算法 并 不 是 提高 性 能 的 唯一 方法 ， 也 不 是 实现 
并 发 版 本 的 唯一 方法 ， 但 它 是 一 个 相对 来 说 比较 简单 直接 的 方法 。 


为 了 实现 这 个 并 发 算法 ， 我 们 需要 对 mosaic 处 理 器 函数 做 一 些 修 
改 。 之 前 展示 的 程序 只 有 mosaic 这 一 个 创建 马赛 克 图 片 的 处 理 器 函 
数 ， 但 是 对 并 发 版 的 web 应 用 来 说 ， 我 们 需要 从 mosaic 函数 中 分 离 出 
cut 和 combine 这 两 个 独立 的 函数 ， 然 后 再 在 mosaic 函数 中 调用 它 





们 。 代 码 清单 9-18 展 示 了 修改 后 的 mosaic 函数 。 


























代码 清单 9-18 并 发 版 的 mosaic 处 理 器 函数 

















func mosaic(w http.ResponseWriter, r *http.Request) { 
tO := time.Now() 
r.ParseMultipartForm(1048576@) // max body in memory is 10MB 
file, _, _ := r.FormFile("image" ) 
defer file.Close() 
tileSize, _ := strconv.Atoi(r.FormValue("tile_ size") ) 
original, _, _ := image.Decode(file) 
bounds := original.Bounds() 
db := cloneTilesDB() 


c1 := cut(original, &db, tileSize, bounds.Min.X, bounds.Min.Y, 
=bounds.Max.X/2, bounds .Max.Y/2)@ 

c2 := cut(original, &db, tileSize, bounds.Max.X/2, bounds .Min.Y, 
wbounds.Max.X, bounds.Max.Y/2)@ 

c3 := cut(original, &db, tileSize, bounds.Min.X, bounds.Max.Y/2, 
æbounds.Max.X/2, bounds.Max.Y)@ 

c4 := cut(original, &db, tileSize, bounds.Max.X/2, bounds.Max.Y/2, 
æbounds.Max.X, bounds.Max.Y)@ 

c := combine(bounds, c1, c2, c3, c4) @ 


buf1 := new(bytes.Buffer) 
jpeg.Encode(buf1, original, nil) 
originalStr := base64.StdEncoding.EncodeToString(bufi1.Bytes() ) 


t1 := time.Now() 
images := map[string]|string{ 
"original": originalStr, 
"mosaic": <-C, 
"duration": fmt.Sprintf("%v ", t1.Sub(t@)), 


} 
t, _ := template.ParseFiles("results.html") 
t.Execute(w, images) 


} 





@ 以 书 形 散 开 方 式 分 割 图 片 以 便 单 独 进行 处 理 


O 以 书 形 聚拢 方式 将 多 个 子 图 片 合并 成 一 个 完整 的 图 片 


cut 函数 会 以 扇形 散 开 (fan-out) 模式 将 目标 图 片 分 割 为 多 个 子 图 
片 ， 如 图 9-7 所 示 。 





图 9-7 将 目标 图 片 分 割 为 4 等 份 


用 户 上 传 的 目标 图 片 将 被 分 割 为 4 等 份 以 便 独 立 处 理 。 注 意 ， 
在 mosaic 函数 里 ， 程 序 调 用 的 都 是 普通 函数 而 不 是 goroutine， 这 是 因 





为 程序 的 并 发 部 分 存在 于 被 调用 函数 的 内 部 : cut 函数 会 在 内 部 以 
goroutine 方 式 执 行 一 个 匿名 函数 ， 而 这 个 匿名 冰 数 则 会 返回 一 个 通道 作 
为 结果 。 


需要 注意 的 是 ， 因 为 我 们 正在 答 试 将 一 个 程序 转换 为 相应 的 并 发 版 
本 ， 而 并 发 程序 通常 都 需要 同时 运行 多 个 goroutine， 所 以 如 果 程 序 需要 
在 这 些 goroutine 之 间 共 至 一 些 资 源 ， 那 么 针对 这 些 资源 的 修改 将 有 可 能 
会 导致 竞争 条 件 出 现 。 
































如 果 一 个 程序 在 执行 时 依赖 于 特定 的 顺序 或 时 序 ， 但 是 又 无 法 保证 这 种 顺序 或 时 序 ， 此 
时 就 会 存在 竞争 条 件 (race condition〉。 竞 争 条 件 的 存在 将 导致 程序 的 行为 变 得 飘忽 不 定 而 
且 难 以 预测 。 



































竞争 条 件 通常 出 现在 那些 需要 修改 共享 资源 的 并 发 程序 当中 。 当 有 两 个 或 多 个 进程 或 线 
程 同时 去 修改 一 项 共享 资源 时 ， 最 先 访问 资源 的 那个 进程 /线程 将 得 到 预期 的 结果 ， 而 其 他 进 
程 /线程 则 不 然 。 最 终 ， 因 为 程序 无 法 判断 哪个 进程 /线程 最 先 访问 了 资源 ， 所 以 它 将 无 法 产生 
一 致 的 行为 。 











































































































虽然 竞争 条 件 一 般 都 不 太 好 发 现 ， 但 修复 一 个 已 判明 的 竞争 条 件 通 常 来 说 并 不 是 一 件 难 
事 。 




















本 节 介 绍 的 马赛 克 图 片 生成 Web 应 用 同样 也 拥有 共享 资源 : 用户 在 
将 目标 图 片上 传 至 Web 应 用 之 后 ，nearest 函数 就 会 从 瓷砖 图 片 数 据 库 
中 寻找 与 之 最 为 匹配 的 瓷 并 从 数据 库 中 移 除 被 选中 的 图 片 以 防 
相同 的 图 片 重复 出 现 。 这 就 意味 着 ， 如 果 多 个 cut K so 
WERE Tl] in Al PA ae EVE BR hae TEER 











为 了 消除 这 一 竞争 条 件 ， 我 们 可 以 使 用 一 种 名 为 互 斥 〈mutual 


exclusion, faj#K“mutex ”) 的 技术 ， 该 技术 可 以 将 同一 时 间 内 访问 临界 
区 (critical section) 的 进程 数量 限制 为 一 个 。 对 马赛 克 图 片 生成 Web 应 
用 来 说 ， 我 们 需要 在 nearest 函数 中 实现 互 斥 ， 以 此 来 保证 同一 时 间 内 
只 能 有 一 个 goroutine 对 瓷砖 图 片 数据 库 进 行 修改 。 


为 了 满足 这 一 点， 程序 需要 用 到 Go 标准 库 sync 包 中 的 Mutex 结 
构 。 首 先 要 做 的 是 定义 一 个 DB 结构 ， 并 在 该 结构 中 封装 实际 的 瓷砖 图 
片 数据 库 以 及 mutex 标志 ， 具 体 如 代码 清单 9-19 所 示 。 



































代码 清单 9-19 DB 结构 


type DB struct { 
mutex *sync.Mutex 
store map[string][3]float64 


} 





接着 ， 如 代码 清单 9-20 所 示 ， 将 nearest 函数 修改 为 DB 结构 的 一 
个 方法 。 




















代码 清单 9-20 nearest 方法 








func (db *DB) nearest(target [3]float64) string { 

var filename string 
db.mutex.Lock() @ 
smallest := 1000000.0 
for k, v := range db.store { 

dist := distance(target, v) 

if dist < smallest { 

filename, smallest = k, dist 


} 


delete(db.store, filename) 
db.mutex.Unlock() @ 
return filename 


pO 


@ 通过 加 锁 设置 mutex 标志 


O 通过 解锁 移 除 mutex 标志 





需要 注意 的 是 ， 因 为 在 从 数据 库 里 移 除 被 选中 的 图 片 之 前 ， 多 个 
goroutine 还 是 有 可 能 会 把 相同 的 瓷砖 图 片 设置 为 最 佳 的 匹配 结果 ， 所 以 
只 锁 住 delete 函数 是 无 法 移 除 苋 争 条 件 的 ， 因 此 修改 后 的 nearest K 
数 将 把 寻找 最 佳 匹 配 瓷砖 图 片 的 整个 区 域 (section〉 都 锁 住 。 





代码 清单 9-21 展 示 了 cut 函数 的 具体 代码 。 





代码 清单 9-21 cut 函数 








func cut(original image.Image, db *DB, tileSize, x1, y1, x2, y2 int) <-cha 
n 


image.Image { @ 
c := make(chan image.Image) @ 
sp := image.Point{@, ©} 
go func() { © 
newimage := image.NewNRGBA(image.Rect(x1, y1, x2, y2)) 
for y := yl; y < y2; y = y + tileSize { 
for x := x1; x < x2; x = x + tileSize { 
r, g, b, _ := original.At(x, y).RGBA() 
color := [3]float64{float64(r), float64(g), float64(b)} 
nearest := db.nearest(color) @ 
file, err := os.Open(nearest) 
if err == nil { 
img, _, err := image.Decode(file) 
if err == nil { 
t := resize(img, tileSize) 
tile := t.SubImage(t.Bounds() ) 
tileBounds := image.Rect(x, y, x+tileSize, y+tileSize) 
draw.Draw(newimage, tileBounds, tile, sp, draw.Src) 
} else { 
fmt.Printlin("error:", err) 


} 
} else { 


fmt.Println("error:", nearest) 
} 
file.Close() 


} 
c <- newimage.SubImage(newimage.Rect) 
}() 


return c 





Q 把 指向 DB 结构 的 引用 传递 给 DB 结构 ， 而 不 是 仅仅 传 入 一 个 映 


O 这 个 通道 将 作为 函数 的 执行 结果 返回 给 调用 者 


© 创建 匿名 的 goroutine 





O 调用 DB 结构 的 nearest 方法 来 获取 最 匹配 的 瓷砖 图 片 





并 发 版 的 马 冤 元 图 片 生成 Web 应 用 跟 原 来 的 非 并 发 版 本 拥有 相同 的 
逻辑 : 它 首 移 在 cut 函数 里 创建 一 个 通道 ， 并 局 动 一 个 匿名 goroutine 来 
计算 将 要 被 发 送 至 该 通道 的 马赛 克 处 理 结果 ， 接 着 再 把 这 个 通道 返回 给 
cut 函数 的 调用 者 。 这 样 一 来 ，cut 函数 创建 的 通道 就 会 立即 返回 给 
mosaic 处 理 器 函数 ， 而 通道 对 应 的 马赛 珊 子 图 片 则 会 在 处 理 完 毕 之 后 
被 发 送 至 通道 。 另 外 需要 注意 的 是 ， 虽 然 cut 函数 创建 的 是 一 个 双 问 通 
道 ， 但 是 如 果 需 要， 我 们 也 可 以 在 返回 这 个 通道 之 前 ， 通 过 类 型 转换 

(typecast) 将 它 转换 成 一 个 只 能 接收 信息 的 单 同 通道 。 








在 把 用 户 上 传 的 目标 图 片 分 割 为 4 等 份 并 将 它们 分 别 转 换 为 马赛 克 
图 片 的 一 部 分 之 后 ， 程 序 接 下 来 就 会 调用 代码 清单 9-22 所 示 的 combine 


PAB, GRE Cfan-in) 模式 ， 将 4 张 子 图 片 重新 合并 成 1 张 完整 
HARE 




















代码 清单 9-22 combine MŽ 





func combine(r image.Rectangle, c1, c2, c3, c4 <-chan image.Image) 
<-chan string { 
c := make(chan string) @ 


go func() { @ 
var wg sync.WaitGroup © 
img:= image.NewNRGBA(r) 
copy := func(dst draw.Image, r image.Rectangle, 
src image.Image, sp image.Point) { 
draw.Draw(dst, r, src, sp, draw.Src) 
wg.Done() @ 
} 
wg.Add(4) © 
var s1, s2, s3, s4 image.Image 
var ok1, ok2, ok3, ok4 bool 
for {0 
select { @ 
case s1, oki = <-c1: 
go copy(img, s1.Bounds(), s1, 
image.Point{r.Min.X, r.Min.Y}) 
case s2, ok2 = <-c2: 
go copy(img, s2.Bounds(), s2, 
image.Point{r.Max.X / 2, r.Min.Y}) 
case s3, ok3 = <-c3: 
go copy(img, s3.Bounds(), s3, 
image.Point{r.Min.X, r.Max.Y/2}) 
case s4, ok4 = <-c4: 
go copy(img, s4.Bounds(), s4, 
image.Point{r.Max.X / 2, r.Max.Y / 2}) 


} 
if (ok1 && ok2 && ok3 && ok4) { © 
break 
} 
} 
wg.Wait() © 


buf2 := new(bytes.Buffer) 
jpeg.Encode(buf2, img, nil) 
c <- base64.StdEncoding.EncodeToString(buf2.Bytes()) 
}() 


return c 
} 


@ 这 个 函数 将 返回 一 个 通道 作为 执行 结 

O 创建 一 个 匿名 goroutine 

O 使 用 等 竺 组 去 同步 各 个 子 图 片 的 复制 操作 

O 每 复制 完 一 张 子 图 片 ， 就 对 计数 器 执行 一 次 减 一 操作 
O 把 等 待 组 计数 器 的 值 设置 为 4 

O 在 一 个 无 限 循 环 里 面 等 待 所 有 复制 操作 完成 

O 等 行 各 个 通道 的 返回 值 

O 当 所 有 通道 都 被 关闭 之 后 ， 跳 出 循环 

© 阻塞 直到 所 有 子 图 片 的 复制 操作 都 执行 完毕 为 止 


跟 cut 函数 一 样 ， 合 并 多 张 子 图 片 的 主要 逻辑 也 放 到 了 匿名 
goroutine 中 ， 并 且 这 些 goroutine 同 样 会 创建 并 返回 一 个 只 能 执行 接收 操 
作 的 通道 作为 结果 。 这 样 一 来 ， 程 序 就 可 以 在 编码 目标 图 片 的 同时 ， 对 
马赛 克 图 片 的 4 个 部 分 进行 合并 。 


在 combine 函数 创建 的 匿名 goroutine 里 ， 程 序 会 构建 另 一 个 匿名 函 
数 ， 并 将 其 赋值 给 变量 copy 。copy 函数 之 后 同样 会 以 goroutine 方 式 运 
行 ， 并 将 给 定 的 马赛 元 子 图 片 复制 到 最 终 的 马赛 元 图 片 中 。 与 此 同时 ， 











因为 程序 无 法 得 知 以 goroutine 方 式 运 行 的 copy 函数 将 于 何 时 结束 ， 所 
以 它 使 用 了 等 竺 组 来 同步 这 些 复制 操作 。 程 序 首 移 创 建 一 个 NaitGroup 
变量 wg ， 并 使 用 Add 方法 将 计数 器 的 值 设置 为 4 。 之 后 ， 每 当 一 个 复制 
操作 执行 完毕 的 时 候 ，copy 函数 都 会 调用 Done 方法 ， 把 等 竺 组 计数 器 
的 值 减 1。 最 后 ， 程 序 把 一 个 Wait 方法 调用 放 在 了 最 终生 成 的 马赛 克 图 
片 的 编码 操作 之 前 ， 以 此 来 保证 程序 只 会 在 所 有 复制 goroutine 都 已 执行 
完毕 ， 并 且 程 序 已 经 拥有 了 完整 的 最 终 马 客 克 图 片 之 后 ， 才 会 开始 对 图 
片 进行 编码 。 


一 个 需要 注意 的 地 方 是 ，combine 函数 接受 的 输入 包含 了 4 个 来 自 
cut 函数 的 通道 ， 这 些 通道 包含 了 马赛 区 图 片 的 各 个 组 成 部 分 ， 并 且 程 
序 不 知道 这 些 部 分 何 时 才 会 通过 通道 传输 过 来 。 昌 然 程 序 可 以 按 顺 序 一 
个 接 一 个 从 这 些 通道 里 接收 信息 ， 但 这 种 做 法 并 不 符合 并 发 程序 的 风 
格 。 为 此 ， 程 序 使 用 了 select 方法 ， 以 先 到 先 服务 的 方式 来 接收 这 些 
通道 及 送 的 信息 。 





这 样 做 的 结果 是 ， 程 序 会 在 一 个 无 限 循环 里 面 进行 欠 代 ， 并 且 每 次 
迭代 都 会 使 用 select 去 获取 其 中 一 个 已 就 绪 通 道 传送 的 子 图 片 〈 如 采 
同时 有 多 个 子 图 片 可 用 ， 那 么 Go 将 随机 选择 其 中 一 个 ) ， 然 后 以 
goroutine 方 式 执行 copy 函数 ， 将 接收 到 的 子 图 片 复 制 到 最 终生 成 的 号 
完 克 图片 当 中 。 因 为 程序 使 用 了 多 值 格 式 (multivalue format) KEk 
道 的 返回 值 ， 而 通道 的 第 二 个 返回 值 ( 即 ok1 、ok2 、ok3 和 ok4 ) 可 
以 说 明 程 序 是 否 已 经 成 功 地 接收 了 各 个 通道 传送 的 子 图 片 ， 所 以 在 无 限 
循环 的 末尾 ， 程 序 会 通过 检测 这 些 返 回 值 来 决定 是 否 跳 出 循环 。 








因为 程序 在 接收 到 所 有 子 图 片 之 后 ， 还 需要 在 4 个 goroutine 里 分 别 


复制 这 些 子 图 片 ， 而 这 些 复制 操作 的 完成 时 间 是 不 确定 的 。 为 了 解决 这 
个 问题 ， 程 序 会 调用 之 前 定义 的 等 竺 组 变量 wg 的 Wait 方法 ， 对 最 终生 
成 的 马赛 殉 图 片 的 编码 操作 进行 阻塞 ， 直 到 上 述 复制 操作 全 部 执行 完毕 
为 止 。 

现在 ， 我 们 终于 拥有 了 一 个 并 发 版 的 马 冤 克 图片 生成 Web 应 用 ， 接 
下 来 是 时 候 运 行 一 下 它 了 。 首 先 ， 假 设 程序 位 于 mosaic_concurrent 
目录 当中 ， 那 么 在 使 用 go build 构建 该 程序 之 后 ， 我 们 可 以 通过 执行 
以 下 命令 ， 使 用 单个 CPU 去 运行 它 : 


GOMAXPROCS=1 ./mosaic_concurrent 


如 果 一 切 正常 ， 将 会 看 到 图 9-8 所 示 的 结果 ， 生 成 这 个 结果 时 使 用 
的 目标 图 片 以 及 瓷砖 图 片 跟 之 前 运行 非 并 发 版 本 时 是 完全 一 样 的 。 








由 于 并 发 版 程序 在 将 4 张 子 图 片 合 并 成 1 张 完整 的 马赛 克 图 片 的 时 
候 ， 没 有 对 子 图 片 的 毛 边 进行 平滑 处 理 ， 所 以 如 果 你 仔细 对 比 就 会 发 
现 ， 这 次 生成 的 马赛 元 图 片 跟 之 前 非 并 发 版 本 生成 的 马赛 克 图 片 是 有 一 
点 细微 区 别 的 《从 彩色 显示 的 电子 书 上 会 更 为 明显 地 看 出 这 一 点 ) 。 尽 
管 生成 的 马赛 克 图 片 有 些 细微 的 不 同 ， 但 并 发 版 程序 的 性 能 提升 是 非常 
明显 的 一 一 非 并 发 版 的 马赛 克 图 片 生 成 Web 应 用 处 理 相同 的 目标 图 片 耗 
费 了 2.25s， 而 并 发 版 本 只 耗费 了 646 hs， 后 者 的 性 能 比 前 者 提高 了 几乎 
有 4 倍 之 多 。 
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图 9-8 ”并 发 版 的 马赛 克 照 片 生成 Web 应 用 





初 看 上 去 ， 我 们 所 做 的 似乎 只 是 将 一 个 函数 分 割 成 4 个 独立 运行 的 
goroutine， 以 此 来 实现 一 个 并 发 版 本 的 Web 程 序 ， 但 如 果 我 们 再 进 一 
步 ， 以 并 行 的 方式 去 运行 这 个 程序 ， 结 果 又 会 如 何 呢 ? 


别 筷 了 ， 在 前 面 的 程序 中 ， 我 们 不 仅 将 一 个 运行 非常 耗 时 的 处 理 器 
函数 分 割 成 了 几 个 独立 运行 的 cut 函数 goroutine， 而 且 我 们 还 
在 combine 函数 里 使 用 多 个 goroutine 来 独立 地 组 合 马赛 克 图 片 的 各 个 部 
分 。 每 当 一 个 cut 函数 完成 了 它 的 工作 之 后 ， 它 就 会 将 处 理 的 结果 发 送 
给 与 之 对 应 的 combine 函数 ， 而 后 者 则 会 将 这 一 结 末 复 制 到 最 终生 成 的 
马赛 元 图 片 当中 。 


除 此 之 外 ， 别 忘 了 ， 在 前 面 运行 非 并 发 版 本 和 并 发 版 本 的 号 赛 元 图 
片 生成 Web 应 用 时 ， 我 们 都 只 使 用 了 一 个 CPU。 正 如 之 前 所 说 ， 并 发 不 
是 并 行 一 一 本 节 前 面 的 内 容 已 经 展示 了 如 何 将 一 个 简单 的 算法 分 解 为 
相应 的 并 发 版 本 ， 其 中 不 涉及 任何 并 行 计 算 : 尽管 这 些 goroutine 能 够 以 
并 发 方式 运行 ， 但 是 因为 只 有 一 个 CPU 可 用 ， 所 以 这 些 goroutine 实 际 上 
并 没有 以 并 行 的 方式 运行 。 








为 了 让 故事 有 一 个 圆满 的 结局 ， 现 在 我 们 可 以 通过 执行 以 下 命令 ， 
以 并 行 的 方式 ， 在 多 个 CPU 以 及 进程 上 运行 并 发 版 的 马赛 克 图 片 生成 
Web 应 用 : 


./mosaic_concurrent 


图 9-9 展 示 了 上 述 命令 的 执行 结果 。 





正如 结果 中 打印 的 时 间 所 示 ， 并 行 运行 的 并 发 程序 比 单纯 的 并 发 程 
序 又 获得 了 大 约 3 倍 的 性 能 提升 ， 具 体 时 间 从 原来 的 646 hs 减少 到 了 现在 
的 216 ps! 如 果 我 们 把 这 一 结果 跟 最 初 的 非 并 发 版 本 所 需 的 2.25 s 相 比 ， 
那么 新 程序 的 性 能 提升 足 有 10 倍 之 多 。 





对 马赛 克 图 片 生成 Web 应 用 来 说 ， 非 并 发 版 本 跟 并 发 版 本 使 用 的 图 
片 处 理 算 法 是 完全 相同 的 。 实 际 上 ， 两 个 版 本 的 mosaic.go Wi CFE 
别 并 不 大 ， 它 们 之 间 的 主要 区 别 在 于 是 否 使 用 了 并 发 特性 ， 这 是 提高 程 
序 性 能 的 关键 。 
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图 9-9 ”使 用 8 个 CPU 运行 并 发 版 的 马赛 克 图 片 生 成 Web 应 用 


完成 了 马赛 克 图 片 生 成 Web 应 用 之 后 ， 在 接 下 来 的 一 章 ， 我 们 要 考 
虑 的 就 是 如 何 部 署 Web 应 用 和 Web 服 务 了 。 





95 小结 





Go Web 服 务 器 本 吴 是 并 发 的 ， 服 务 吉 会 把 接收 到 的 每 条 请 求 都 放 
到 独立 的 goroutine 里 运行 。 

并 发 和 并 行 是 两 个 相辅相成 的 概念 ， 但 它们 并 不 相同 。 并 发 指 的 是 
两 个 或 多 个 任务 在 同一 时 间 段 内 启动 、 运 行 和 结束 ， 并 且 这 些 任务 
可 能 会 彼此 互动 ， 而 并 行 则 是 单纯 地 同时 运行 多 个 任务 。 

Go 通过 goroutine 和 通道 这 两 个 重要 的 特性 直接 文 持 并 发 ， 但 Go 并 
不 直接 支持 并 行 。 

goroutine 用 于 编写 并 发 程序 ， 而 通道 则 用 于 为 不 同 的 goroutine 之 间 
提供 通信 功能 。 

无 缓冲 通道 都 是 同步 的 ， 答 试问 一 个 已 经 包含 数据 的 无 缓冲 通道 推 
入 新 的 数据 将 被 阻塞 ， 但 是 ， 有 绥 冲 通道 在 被 填 满 之 前 都 是 异步 
的 。 

select 语句 可 以 以 先 到 先 服 务 的 方式 ， 从 多 个 通道 里 选 出 一 个 已 
经 准备 好 执行 接收 操作 的 通道 。 

WaitGroup 同样 可 以 用 于 对 多 个 通道 进行 同步 。 

并 发 程序 的 性 能 一 般 都 会 比 相 应 的 非 并 发 程序 要 高 ， 而 具体 提升 多 
少 则 取决 于 所 使 用 的 算法 (即使 在 只 使 用 一 个 CPU 的 情况 下 ， 也 是 














如 此 ) 。 
。 在 条 件 允许 的 情况 下 ， 并 发 的 Web 应 用 将 自动 地 获得 并 行 带 来 的 优 
势 


[1] 原 书 说 Go 1.4 goroutine 的 局 动 栈 大 小 为 8 KB， 但 根据 资料 ， 这 个 栈 





的 大 小 应 该 是 2KB 才 对 ， 上 所 以 在 译文 里 面 进行 了 修正 。《 资 料 链接 : 
https://golang.org/doc/go1.4#runtime. ) 一 一 译 者 注 


第 10 章 Go 的 部 署 


© 把 Go Web 应 用 部 署 到 独立 服务 器 
。 把 Go Web 应 用 部 署 到 云端 
。 把 Go Web 应 用 部 署 到 Docker 容 器 





在 学 习 了 如 何 使 用 Go 开发 Web 应 用 之 后 ， 接 下 来 要 考虑 的 自然 就 是 
如 何 部 署 这 些 应 用 了 。Web 应 用 跟 其 他 类 型 的 应 用 在 部 获 方 式 上 存在 着 
非常 大 的 不 同 。 比 如 ， 昌 面 应 用 和 移动 应 用 就 是 部 署 在 智能 手机 、 平 板 
电脑 、 手 提 电 脑 等 终端 用 户 的 设备 上 ， 而 Web 应 用 则 是 部 嗜 在 服务 器 
上 ， 然 后 通过 终端 用 户 设备 上 的 浏览 喜 等 客户 端 对 其 进行 访问 。 








因为 Go 的 可 执行 程序 都 会 被 编译 为 单独 的 二 进 制 文件 ， 所 以 部 署 
Go Web 应 用 程序 在 某 种 程度 上 可 以 说 是 非常 简单 的 。 除 此 之 外 ，Go 还 
可 以 编译 出 不 需要 引用 任何 外 部 库 的 静态 链接 二 进 制 文 件 ， 这 种 文件 可 
以 作为 独立 的 可 执行 文件 存在 。 不 过 一 个 完整 的 Web 应 用 通常 不 会 只 包 
含 一 个 可 执行 文件 ， 它 一 般 还 会 包含 一 些 模板 文件 ， 以 及 诸如 
JavaScript. PAA. PEFR (style sheet) 这 样 的 静态 文件 。 本 章 将 会 介 
绍 几 种 把 Go Web 应 用 部 署 到 互联 网 的 方法 ， 其 中 大 部 分 方法 都 是 通过 
云 供应 两 (cloud provider) 实现 的 。 本 章 将 要 介绍 的 部 署 方法 包括 : 











。 在 一 个 完全 由 用 户 本 人 控制 的 物理 或 虚拟 的 服务 器 上 实施 部 署 ， 本 
章 正 文 将 使 用 IaaS 供 应 商 Digital Ocean 的 服务 器 作为 例子 ; 


。 在 云 PaaS 供 应 商 Heroku 上 实施 部 署 ; 

。 在 男 一 家 云 PaaS 供 应 商 Google App Engine (GAE) 上 实施 部 署 ; 

。 将 应 用 Docker 化 (dockerized) 为 容器 ， 然 后 将 其 部 署 到 本 地 
Docker 服 务 器 以 及 Digital Ocean 的 虚拟 机 上 。 


| aa 





云 计 算 ， 简称 “< 去"， 是 一 种 获取 网 络 和 计算 机 使 用 权限 的 模型 ， 这 种 模型 可 以 提供 一 个 
由 服务 器、 存储 空间 、 网 络 以 及 其 他 可 共享 资源 组 成 的 共享 资源 池 ， 从 而 使 这 些 资源 的 用 户 
可 以 避免 不 必要 的 前 期 投入 ， 也 可 以 让 这 些 资源 的 供应 商 更 加 高 效 地 利用 这 些 资 源 为 更 多 的 
用 户 提 供 服 务 。 云 计算 在 最 近 这 些 年 吸引 了 非常 多 的 关注 ， 时 至 今日 ， 包 括 Amazon、Google 
和 Facebook 在 内 的 绝 大 部 分 基础 设施 以 及 服务 供应 商都 使 用 这 种 模型 作为 他 们 的 标准 收费 模 
型 。 















































需要 注意 的 是 ， 部 辕 一 个 Web 应 用 通常 会 有 很 多 种 不 同 的 方法 可 
选 ， 比 如 ， 本 章 介绍 的 几 种 部 署 方 法 之 间 就 存在 独 非常 多 的 不 同 之 处 。 
还 有 一 点 要 说 明 的 是 ， 本 章 介 绍 的 部 普 方 法 关注 的 是 如 何 部 车 个 人 的 
Web 应 用 ， 真 正 生 产 环境 下 的 部 署 通常 会 包含 运行 测试 僚 件 、 实 施 持续 
集成 以 及 调整 服务 占 等 一 系列 额外 的 任务 ， 具 体 过 程 会 比 这 里 介绍 的 要 
复杂 得 多 。 











本 草 虽 然 介 绍 了 很 多 概念 和 工具 ， 但 由 于 这 些 概念 和 工具 每 个 都 什 
得 用 整整 一 本 书 的 访 幅 去 介绍 ， 所 以 本 半 并 没有 试图 全 面 讲解 这 些 技 术 
和 服务 。 相 反 ， 本 章 只 会 关注 这 些 技术 的 一 部 分 知识 ， 读 者 可 以 把 这 些 
知识 看 作 是 学 习 相 关 技 术 的 起 点 。 











本 章 展 示 的 部 署 例子 将 会 用 到 7.6 节 介绍 过 的 简单 Web 服 务 ， 并 在 条 
件 人 允许 的 情况 下 使 用 PostgreSQL (因为 GAE 不 文 持 PostgreSQL， 所 以 在 





介绍 GAE 的 部 蜀 方 法 时 ， 本 章 将 使 用 基于 MySQL 的 Google Cloud 

SQL) 。 与 此 同时 ， 本 章 还 会 假设 独立 的 数据 库 服 务 器 上 已经 预先 设置 
好 了 数据 库 的 相关 设置 ， 所 以 本 章 将 不 会 介绍 具体 的 数据 库 设 置 方法 ， 
有 需要 的 读者 可 以 通过 复习 2.6 节 来 获得 一 个 简短 的 设置 介绍 。 








10.1 将 应 用 部 普 到 独立 的 服务 需 





让 我 们 从 最 简 蛙 的 部 署 方 法 开始 一 一 创建 一 个 可 执行 的 二 进 制 文 
件 ， 并 将 它 放 到 互联 网 的 某 个 服务 器 上 运行 ， 这 个 服务 器 可 以 是 物理 存 
在 的 ， 也 可 以 是 由 Amazon Web Services (AWS) 或 者 Digital Ocean 等 供 
应 商 创 建 的 虚拟 机 〈VM) 。 在 本 市 中 ， 我 们 将 要 学 习 如 何在 运行 着 
Ubuntu Server 14.04 A WIRI aL Hb Go Web 应 用 。 








由 Iaas、PaaS 和 Saas 














云 计 算 供 应 商都 会 通过 不 同 的 模型 来 为 用 户 提供 服务 。 美 国 国家 标准 技术 研究 所 
(National Institute of Standards and Technology, US Department of Commerce, NIST) 定义 了 当 
今 广 为 使 用 的 3 种 服务 模型 ， 分 别 是 基础 设施 即 服务 CInfrastructure-as-a-Service, IaaS) ， 平 
台 即 服务 (Platform-as-a- Service, PaaS) 和 软件 即 服务 (Software-as-a-Service，SaaS) 。 




















Iaas 是 这 3 种 模型 中 最 为 基本 的 一 种 ， 使 用 这 种 模型 的 供应 商 将 向 他 们 的 用 户 提供 包括 计 
算 、 存 储 以 及 网 络 在 内 的 基本 计算 能 力 。 提 供 IaaS 服 务 的 例子 有 AWS 的 弹性 云 计算 服务 
(Elastic Cloud Computing Service, EC2) 、Google 公 司 的 Compute Engine 〈 计 算 引 擎 ) 以 及 

















Digital Ocean 的 Droplets。 


























使 用 PaaS 模 型 的 供应 商会 让 用 户 通 过 他 们 提供 的 工具 ， 将 应 用 部 署 到 云端 的 基础 设施 之 
上 。 提 供 PaaS 服 务 的 例子 有 Heroku、AWS 的 Elastic Beanstalk 以 及 Google 公 司 的 App Engine. 











使 用 SaaS 模 型 的 供应 商会 名 用 户 提 供应 用 服务 。 尽 管 消费 者 当今 使 用 的 绝 大 多 数 服务 都 
可 以 看 作 是 SaaS 服 务 ， 但 是 在 本 书 的 语 境 中 ， 我 们 只 会 把 Heroku 的 Postgres 数据 库 服务 
(Postgres database service， 它 提供 的 是 基于 云 的 Postgres 服 务 ) 、AWS 的 Relational Database 
Service (关系 数据 库 服务 ，RDS)〉 以 及 Google 公 司 的 Cloud SQL 〈 云 SQL ) 这 样 的 服务 看 作 是 
SaaS 服 务 。 





























在 本 章 中 ， 我 们 将 学 习 如 何 利 用 IaaS 和 PaaS 供 应 商 来 部 署 GoWeb 应 用 。 











本 书 第 7 章 介 绍 过 的 简单 Web 服 务 由 代码 清单 10-1 中 的 data.go 和 
代码 清单 10- Bi esr go 这 两 个 文件 组 成 ， 前 者 包含 了 所 有 指 癌 数 
据 库 的 连接 和 所 有 对 数据 库 进行 读 写 的 函数 ， 而 后 者 则 包含 了 main K 
数 和 Web 服 务 的 所 有 处 理 逻 辑 。 

















代码 清单 10-1 使 用 data. go 访问 数据 库 

















package main 


import ( 

"database/sql" 

_ "github.com/lib/pq" 
) 


var Db *sql.DB 


func init() { 
var err error 
Db, err = sql.Open("postgres", "user=gwp dbname=gwp password=gwp 
æsslmode=disable") 
if err != nil { 
panic(err) 
} 
} 


func retrieve(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = 
$1", id).Scan(&post.Id, &post.Content, &post.Author) 


return 
} 
func (post *Post) create() (err error) { 
statement := "insert into posts (content, author) values ($1, $2) 
wreturning id" 
stmt, err := Db.Prepare(statement) 
if err != nil { 
return 
} 


defer stmt.Close() 
err = stmt.QueryRow(post.Content, post.Author).Scan(&post.Id) 
return 


func (post *Post) update() (err error) { 
_, err = Db.Exec("update posts set content = $2, author = $3 where id = 
$1", post.Id, post.Content, post.Author) 
return 
} 
func (post *Post) delete() (err error) { 
_, err = Db.Exec("delete from posts where id = $1", post.Id) 
return 


} 














代码 清单 10-2 ”定义 了 Go Web 服 务 的 server .go 

















package main 


import ( 
"encoding/json" 
"net/http" 
"path" 
"strconv" 

) 


type Post struct { 
Id int `json: "id" 
Content string `json:"content 
Author string `json:"author"` 


} 
func main() { 
server := http.Server{ 
Addr: "127.0.0.1:8080", 
} 


http.HandleFunc("/post/", handleRequest) 
server.ListenAndServe() 


} 


func handleRequest(w http.ResponseWriter, r *http.Request) { 
var err error 
switch r.Method { 


case "GET": 
err = handleGet(w, r) 
case "POST": 


err = handlePost(w, r) 
case "PUT": 


err = handlePut(w, r) 
case "DELETE": 
err = handleDelete(w, r) 


} 

if err != nil { 
http.Error(w, err.Error(), http.StatusInternalServerError) 
return 

} 


} 


func handleGet(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 
} 
post, err := retrieve(id) 
if err != nil { 
return 
} 
output, err := json.MarshalIndent(&post, "", "\t\t") 
if err != nil { 
return 
} 


w.Header().Set("Content-Type", "application/json") 
w.Write(output) 
return 


} 


func handlePost(w http.Responsewriter, r *http.Request) (err error) { 
len := r.ContentLength 
body := make([]byte, len) 
r.Body.Read(body ) 
var post Post 
json.Unmarshal(body, &post) 
err = post.create() 


if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


} 


func handlePut(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 
if err != nil { 
return 


} 


post, err := retrieve(id) 
if err != nil { 

return 
} 
len := r.ContentLength 
body := make([]byte, len) 
r .Body .Read (body) 
json.Unmarshal(body, &post) 
err = post.update() 


if err != nil { 
return 

} 

w.WriteHeader (200) 

return 


} 


func handleDelete(w http.ResponseWriter, r *http.Request) (err error) { 
id, err := strconv.Atoi(path.Base(r.URL.Path) ) 


if err != nil { 
return 

} 

post, err := retrieve(id) 

if err != nil { 
return 

} 

err = post.delete() 

if err != nil { 
return 

} 

w.WriteHeader (200) 

return 








首先 ， 我 们 需要 使 用 以 下 命令 编译 这 段 代码 : 


go build 


如 果 我 们 把 简单 Web 服 务 的 代码 放 到 一 个 名 为 ws-s 的 目录 里 ， 那 
么 这 个 编译 命令 将 产生 一 个 同名 的 可 执行 二 进 制 文件 。 为 了 部 普 Web 服 


Sws-s ， 我 们 需要 把 ws-s 文 件 复 制 到 服务 器 里 ， 并 将 其 放置 到 一 个 可 
以 通过 外 部 访问 的 地 方 。 


接着 我 们 只 需要 登录 服务 器 ， 并 在 终端 里 执行 以 下 命令 ， 就 可 以 运 
行 ws-s 这 个 Web 服 务 了 : 


./WS-S 


需要 注意 的 是 ， 因 为 Web 服 务 现在 是 在 前 台 运行 ， 所 以 在 服务 运行 
期 间 ， 我 们 将 无 法 执行 其 他 操作 。 与 此 同时 ， 我 们 也 无 法 简单 地 通过 & 
命令 或 者 bg 命令 在 后 台 运行 这 个 服务 ， 因 为 这 样 做 的 话 ， 一 旦 用 户 合 
出 ，Web 服 务 就 会 被 杀 死 。 





避免 上 述 问题 的 一 种 方法 就 是 使 用 nohup 命令 ， 让 操作 系统 在 用 户 
注销 时 ， 把 发 送 至 Web 服 务 的 HUP (hangup， 挂 起 ) 信号 忽略 掉 : 


nohup ./ws-s & 


执行 上 述 命 令 将 导 臻 Web 服务 被 放 到 后 台 运 行 ， 并 且 不 用 担心 因 
为 HUP 信和 号 而 被 杀 死 。 以 这 种 方式 局 动 的 Web 服 务 仍 会 如 音 地 与 客户 端 
进行 连接 ， 但 现在 的 Web 服务 将 忽略 所 有 挂 起 或 者 退出 信号 。 因 为 这 种 
状态 下 运行 的 Web 服 务 在 骨 尝 时 将 不 会 有 任何 提醒 ， 所 以 在 服务 朋 演 或 
者 服务 器 重启 之 后 ， 用 户 必 须 重新 登入 系统 并 重启 服务 。 








除 nohup 之 外 ， 持 续 运 行 Web 服 务 的 另 一 种 方法 是 使 用 Upstart 或 者 
systemd 这 样 的 init 守护 进程 ，init 进程 是 类 Unix 系 统 在 启动 时 运行 的 





第 一 个 进程 ， 该 进程 由 内 核 负 责 局 动 ， 它 会 一 直 运 行 直 到 系统 关闭 为 
止 ， 并 且 它 还 是 其 他 所 有 进程 直接 或 间接 的 祖先 。 


Upstart 是 由 Ubuntu 创建 的 一 个 基于 事件 的 init 蔡 代 品 ， 尽 管 现在 
systemd 也 越 来 越 受 到 大 家 的 青睐 ， 但 考虑 到 这 两 个 工具 都 能 够 完成 本 
节 介 绍 的 工作 ， 并 且 Upstart 的 使 用 方法 相对 来 说 要 更 为 简单 一 些 ， 所 以 
我 们 接 下 来 将 要 学 习 如 何 使 用 Upstart 来 持续 地 运行 Web 服 务 。 


为 了 使 用 Upstart， 用 户 首 先 需 要 创建 一 个 对 应 的 Upstart 任 务 配置 文 
件 ， 并 将 该 文件 放 到 etc/init 目录 里 面 。 对 简单 Web 服 务 来 说 ， 我 们 
将 创建 代码 清单 10-3 所 示 的 ws .conf 文件 ， 并 将 它 放 到 etc/init 目录 
里 面 。 

















代码 清单 10-3 ”简单 Web 服 务 的 Upstart 任 务 配置 文件 














respawn 
respawn limit 10 5 


setuid sausheong 
setgid sausheong 


exec /go/src/github.com/sausheong/ws-s/ws-s 





这 个 Upstart 任 务 配置 文件 非常 简单 和 直接 。 文 件 中 的 每 个 Upstart 任 
务 都 由 一 个 或 任意 多 个 称 为 节 Cstanzas) 的 命令 块 组 成 。 第 一 节 
respawn 指示 当 任务 失效 (fail) 时 ，Upstart 将 对 其 实施 重新 派生 
(respawn) 或 者 重新 启动 。 第 二 节 respawn limit 16 5 为 respawn 
设置 了 参数 ， 它 指示 Upstart 最 多 只 会 答 试 重新 派生 该 任务 10 次 ， 并 且 每 
次 尝试 之 间 会 有 5 s 的 间隔 ;在 用 完了 10 次 重新 派生 的 机 会 之 后 ，Upstart 





将 不 再 尝试 重新 派生 该 任务 ， 并 将 该 任务 视 为 已 失效 。 第 三 节 和 第 四 节 
ATR aim 行进 程 的 用 户 以 及 用 户 组 ， 而 最 后 一 市 则 是 Upstart 在 局 动 任 
务 时 需要 运行 的 可 执行 文件 。 














为 了 局 动 上 述 Upstart 任 务 ， 我 们 需要 在 终端 里 面 执 行 以 下 命令 : 


sudo start ws 
ws start/running, process 2011 





这 个 命令 将 触发 Upstart 读 取 /etc/init/ws .conf 任务 配置 文件 并 
局 动 任务 。 本 市 以 管 中 舌 豹 的 方式 ， 快 速 地 了 解 了 如 何 使 用 简单 的 
Upstart 任 务 运 行 一 个 Go Web 应 用 ， 但 是 除 这 里 介绍 的 内 容 之 外 ， 
Upstart 的 任务 配置 文件 还 有 其 他 不 同 的 节 可 供 使 用 ， 并 且 Upstart 的 任务 
也 拥有 多 种 不 同 的 配置 方式 可 以 使 用 ， 不 过 这 些 内 容 不 在 本 书 的 介绍 范 
围 之 内 ， 有 兴趣 的 读者 可 以 自行 通过 互联 网 进行 了 解 。 


为 了 验证 Upstart 是 否 能 够 正确 地 运行 和 管理 ws-s 服务 ， 我 们 可 以 
党 试 在 Upstart 任 务 启 动 之 后 ， 杀 死 正 在 运行 的 ws-s 服务 : 


ps -ef | grep ws 
sausheo+ 2011 1 @ 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws-s/ws-s 


sudo kill -6 2011 


ps -ef | grep ws 
sausheo+ 2030 1 © 17:23 ? 00:00:00 /go/src/github.com/sausheong/ws-s/ws-s 





注意 看 ， 在 kill 命令 执行 之 前 ，ws-s 进程 的 ID 为 29011 ， 但 是 
在 kill 命令 执行 之 后 ，ws-s 进程 的 ID 变 成 了 2636 一 这 是 因为 


Upstart7Ekill 命令 执行 之 后 ， 察 觉 到 了 ws-s 进程 已 被 关闭 ， 于 是 它 重 
启 了 ws-s 进程 ， 从 而 导致 ws-s 进程 的 ID 发 生 了 变化 。 


最 后 ， 因 为 大 部 分 Web 应 用 都 部 普 在 标准 HITP 端 口 〈 即 80 端 口 ) 
之 上 ， 所 以 读者 在 实际 部 署 时 ， 应 该 将 简单 Web 服 务 代 码 中 的 端口 号 从 
现在 的 8080 改 为 80， 或 者 通过 某 种 机 制 将 8080 病 口 的 流量 代理 或 者 重 定 
向 到 80 端 口 。 





10.2 ”将 应 用 部 署 到 Heroku 





在 上 一 节 中 ， 我 们 学 习 了 如 何 将 一 个 简单 的 Go Web 服 务 部 署 到 独 
立 的 服务 器 上 面 ， 以 及 如 何 通 过 init 守护 进程 管理 Web 服 务 。 在 本 节 
中 ， 我 们 将 要 学 习 如 何 将 同样 的 Web 服 务 部 署 到 PaaS 供 应 商 Heroku 上 
面 ， 这 种 部 署 方式 跟 上 一 节 介 绍 的 部 署 方式 一 样 简单 。 








Heroku 人 允许 用 户 部 署 、 运 行 和 管理 使 用 包括 Go 在 内 的 几 种 编程 语 
言 开发 的 应 用 。 根 据 Heroku 的 定义 ， 一 个 应 用 就 是 由 Heroku 文 持 的 某 
一 种 编程 语言 编写 的 一 系列 源 代 码 ， 以 及 与 这 些 源 代 码 相 关联 的 依赖 关 
系 。 





Heroku 的 预 设 条 件 非常 简单 ， 它 只 要 求 用 户 提供 以 下 几 样 东西 : 


定义 依赖 关系 的 配置 文件 或 者 相关 机 制 ， 如 Ruby 的 Gemfile 文件 、 
Node.js 的 package. json 文件 或 者 Java 的 pom.xml 文件 ; 
定义 可 执行 文件 的 Procfile 文件 ， 其 中 可 执行 文件 可 以 有 不 止 一 


ae 





Heroku 大 量 地 使 用 命令 行 ， 并 因此 提供 了 一 个 名 为 toolbelt 的 命令 行 
工具 ， 用 于 部 署 、 运 行 和 管理 应 用 。 此 外 ，Heroku 还 需要 通过 Git 将 被 
部 署 的 源码 推送 至 服务 器 。 当 Heroku 平 台 接 收 到 Git 推 送 的 代码 时 ， 它 
会 构建 代码 并 获取 指定 的 依赖 关系 ， 然 后 将 构建 的 结果 以 及 相应 的 依赖 
关系 组 闭 到 一 个 slug 里 面 ， 最 后 在 Heroku 的 dynos 上 运行 这 个 
slug (dynos 是 Heroku 对 隔离 式 、 轻 量 级 、 虚 拟 化 的 Unix 容 器 的 称呼 )。 


尽管 菜 些 管理 和 配置 工作 可 以 在 之 后 通过 Web 界 面 来 完成 ， 但 
Heroku 最 主要 的 操作 界面 还 是 它 的 命令 行 工具 toolbelt， 因 此 我 们 在 注册 
完 Heroku 之 后 的 第 一 件 事 ， 就 是 访问 https:// toolbelt.heroku.com F 4 
toolbelt. 





Heroku 是 一 个 非典 型 的 PaaSs 供 应 丙 ， 人 们 想 要 使 用 Paas 来 部 署 Web 
应 用 的 原因 有 很 多 ， 对 Web 应 用 的 开发 者 来 说 ， 最 主要 的 原因 英 过 于 
PaaS 可 以 让 基础 设施 和 系统 层 变 得 抽象 ， 并 且 不 再 需要 人 工 的 管理 和 干 
预 。 尽 管 PaaS 在 企业 级 IT 基础 设施 这 样 的 大 规模 生产 环境 中 并 不 少见 ， 
但 它们 对 小 型 公司 和 创业 公司 来 说 却 能 够 提供 极 大 的 方便 ， 并 且 能 够 有 
效 地 减少 这 些 公司 在 基础 设施 方面 的 前 期 投入 。 











在 下 载 完 toolbelt 之 后 ， 用 户 需要 使 用 注册 账号 时 获得 的 凭据 登入 
Heroku: 
heroku login 


Enter your Heroku credentials. 
Email: <your email> 


Password (typing will be hidden): 
Authentication successful. 





图 10-1 展 示 了 将 简单 Web 服 务 部 着 到 Heroku 的 具体 步 又。 


为 了 将 简单 Web 应 用 部 署 到 Heroku， 我 们 需要 对 这 个 应 用 的 代码 做 
一 些 细微 的 修改 : 在 当前 的 代码 中 ， 应 用 使 用 的 是 8080 端 口 ， 但 是 在 把 
应 用 部 署 到 Heroku 的 时 候 ， 用 户 是 无 法 控制 应 用 使 用 哪个 端口 的 ， 程 序 
必须 通过 读 取 环 境 变 量 PORT 来 获知 自己 能 够 使 用 的 端口 号 。 为 此 ， 我 
们 需要 将 server .go 文件 中 main 函数 的 代码 从 现在 的 : 


func main() { 
server := http.Server{ 
Addr: ":8080", 


http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


} 





修改 为 : 


func main() { 
server := http.Server{ 
Addr: ":" + os.Getenv("PORT"),// @ 


} 
http.HandleFunc("/post/", handlePost) 
server.ListenAndServe() 


} 








@ 从 环境 变量 中 获取 端口 号 


修改 代码 ， 
使 用 Godep 将 代码 推送 
ee 引入 依赖 关系 人 至 Heroku 应 用 


图 10-1 将 Web 应 用 部 署 到 Heroku 的 具体 步 又 




















以 上 就 是 将 简单 Web 应 用 部 署 到 Heroku 所 需要 做 的 全 部 代码 修改 ， 
其 他 代码 只 要 保留 原样 即 可 。 在 修改 完 代 码 之 后 ， 我 们 接 下 来 要 做 的 就 
是 将 简单 Web 应 用 所 需 的 依赖 关系 告知 Heroku。Heroku 使 用 
godep (https://github.com/tools/godep) 来 管理 Go 的 依赖 关系 ，godep 可 

通过 执行 以 下 命令 来 安装 : 


go get github.com/tools/godep 





[L CR 


在 godep 安 装 完 毕 之 后 ， 我 们 需要 使 用 它 来 引入 简单 Web 服 务 的 依 
赖 关系 。 为 此 ， 我 们 需要 在 简单 Web 服 务 的 根 目 录 中 执行 以 下 命令 : 


re 


这 条 命令 不 仅 会 创建 一 个 名 为 Godeps 的 目录 ， 它 还 会 获取 代码 中 
的 全 部 依赖 关系 ， 并 将 这 些 依 赖 关 系 的 源 代 码 复制 
到 Godeps/_workspace 目录 中 。 除 此 之 外 ， 这 个 命令 还 会 创建 一 个 名 
为 Godeps.Jjson 的 文件 ， 并 在 该 文件 中 列 出 代码 中 的 全 部 依赖 关系 。 
作为 例子 ， 代 码 清 单 10-4 展 示 了 godep 为 简单 Web 服 务 创建 的 
Godeps. json 文件 。 








代码 清单 10-4 Godeps.json 文件 





{ 
"ImportPath": "github.com/sausheong/ws-h", 
"GoVersion": "go1.4.2", 
"Deps": [ 


"ImportPath": "github.com/lib/pq", 


"Comment": "go1.0-cutoff-31-ga33d605", 
"Rev": "a33d6053e025943d5dc89dfa1f35fe5500618df7" 





因为 我 们 的 简单 Web 服 务 只 需要 依赖 Postgres 数 据 库 驱动 ， 所 以 文 
件 中 只 出 现 了 关于 该 驱动 的 依赖 信息 。 





在 Heroku 上 实施 部 署 需 要 做 的 最 后 一 件 事 ， 就 是 定义 一 
个 Procfile 文件 ， 并 使 用 该 文件 去 描述 需要 被 执行 的 可 执行 文件 或 者 
主 函 数 。 人 代码 清单 10-5 展 示 了 简单 Web 服 务 的 Procfile 文件 。 











代码 清单 10-5 Procfile 文件 


整个 文件 非常 简单 ， 只 有 短 短 的 一 行 。 这 个 文件 定义 了 Web 进 程 
与 ws-h 可 执行 二 进 制 文件 之 间 的 关联 ，Heroku 在 完成 应 用 的 构建 工作 
之 后 ， 就 会 执行 ws-h 文件 。 

















准备 工作 一 切 就 绪 之 后 ， 我 们 接 下 来 要 做 的 就 是 将 简单 Web 服 务 的 
代码 推送 至 Heroku。Heroku 人 允许 用 户 通过 GitHub 集 成 、Dropbox 同 步 、 
Heroku 官 方 提供 的 API 以 及 标准 的 Git 操 作 等 多 种 不 同 的 手段 来 推送 代 
人 码 。 作 为 例子 ， 本 节 接 下 来 将 展示 如 何 使 用 标准 的 Git 操 作 将 简单 Web 服 
务 推送 至 Heroku。 





在 推送 代码 之 前 ， 用 户 首 先 需 要 创建 一 个 Heroku 应 用 : 


heroku create ws-h 


这 条 命令 将 创建 一 个 名 为 ws-h 的 Heroku 应 用 ， 该 应 用 最 终 将 在 地 
址 https://ws-h.herokuapp.com 上 展示 。 需 要 注意 的 是 ， 因 为 本 书 在 这 里 已 
经 使 用 了 ws-h 作为 应 用 的 名 字 ， 所 以 读者 将 无 法 创建 相同 名 字 的 应 
用 。 为 此 ， 读 者 在 创建 应 用 的 时 候 可 以 使 用 其 他 名 字 ， 或 者 在 创建 应 用 








时 去 掉 名 字 参 数 ， 让 Heroku 为 应 用 目 动 生成 一 个 随机 的 名 字 : 


heroku create 


heroku create 命令 将 为 我 们 的 简单 Web 服 务 创建 一 个 本 地 的 Git 
代码 库 Crepository) ， 并 在 代码 库 中 添加 远程 Heroku 代 码 库 的 地 址 。 
此 ， 用 户 在 创建 完 Heroku 应 用 之 后 ， 束 可 以 通过 以 下 命令 使 用 Git 将 应 
用 代码 推送 至 Heroku; 


git push heroku master 


因为 Heroku 在 接收 到 用 户 推送 的 代码 之 后 就 会 目 动 触发 相应 的 构建 
以 及 部 蜀 操 作 ， 所 以 将 应 用 部 车 到 Heroku 的 工作 到 此 就 可 以 告 一 段落 
了 。 除 上 面 提 到 的 工具 之 外 ，Heroku 还 提供 了 一 系列 非常 棒 的 应 用 管理 
工具 ， 这 些 工具 可 以 对 应 用 进行 性 能 扩展 以 及 版 本 管理 ， 并 且 在 需要 
时 ， 用 户 也 可 以 使 用 Heroku 提 供 的 配置 工具 添加 新 的 服务 ， 有 兴趣 的 读 
者 可 以 目 行 查 疯 Heroku 提 供 的 相关 文档 。 








10.3 ”将 应 用 部 着 到 Google App Engine 


Google App Engine (GAE) 是 男 一 个 流行 的 Go Web H PaaS ih 
平台 。Google 公 司 在 它 的 云 平 台 产品 套件 中 包含 了 App Engine (应 用 引 
擎 ) 和 Compute Engine GTI) 等 多 种 服务 ， 其 中 App Engine 为 
PaaS 服 务 ， 而 Compute Engine 则 跟 AWS 的 EC2 和 Digital Ocean 的 Droplets 
一 样 ， 是 一 个 Iaas 服 务 。 使 用 EC2 和 Droplets 这 样 的 服务 跟 使 用 自 有 的 虚 
拟 机 或 者 服务 器 并 没有 太 大 区 别 ， 并 且 我 们 已 经 在 上 一 节 学 习 过 如 何在 
类 似 的 平台 上 进行 部 署 ， 因 此 在 这 一 节 ， 我 们 要 学 习 如 何 使 用 GAE 这 于 
由 Google 公 司 提供 的 强大 的 PaaS 服 务 。 


人 们 选择 使 用 GAE 而 不 是 包括 Heroku 在 内 的 其 他 PaaS 服 务 的 原因 通 
常会 有 好 几 种 ， 但 其 中 最 主要 的 原因 还 是 跟 性 能 和 可 扩展 性 有 关 。GAE 
能 够 让 用 户 构 建 出 可 以 根据 负载 自动 进行 性 能 扩展 和 负载 平衡 的 应 用 ， 
并 且 Google 公 司 除 为 GAE 提 供 了 大 量 的 工具 之 外 ， 还 在 GAE 内 部 构建 了 
大 量 的 功能 。 比 如 ，GAE 人 允许 用 户 的 应 用 通过 里 份 验证 功能 登录 Google 
账号 ， 并 且 GAE 还 提供 了 发 送 邮 件 、 创 建 日 志 、 人 发布 和 管理 图 片 等 多 种 
服务 。 除 此 之 外 ，GAE 用 户 还 可 以 非常 简单 直接 地 在 自己 的 应 用 中 集成 
其 他 Google API。 





虽然 GAE 拥 有 如 此 多 的 优点 ， 但 天 下 并 没有 免费 的 午餐 一 GAE 在 
拥有 众多 优点 的 同时 ， 也 拥有 不 少 限制 和 缺 点 ， 其 中 包括 : 用 户 只 拥有 
对 文件 系统 的 读 权限 ， 请 求 时 长 不 能 超过 60 s (否则 GAE 将 强制 杀 死 该 
请 求 ) ， 无 法 进行 直接 的 网 络 访问 ， 无 法 创建 其 他 类 型 的 系统 调用 ， 等 
等 。 这 些 限 制 意味 着 用 户 将 不 能 (至 少 是 无 法 轻易 地 ) 访问 Google 应 用 





环境 沙 箱 (sandbox) 之 外 的 其 他 大 量 服务 。 


图 10-2 展 示 了 在 GAE 上 部 署 Wweb 应 用 的 大 致 步骤 。 


修改 代码 ， 使 用 将 应 用 代码 
Google 提 供 的 库 创建 app.yml 文 件 创建 GAE 应 用 推送 至 GAE 平 台 


图 10-2 ”在 GAE 上 部 署 应 用 的 大 致 步 又 























跟 其 他 所 有 Google 服 务 一 样 ， 使 用 GAE 也 需要 一 个 Google 账 号 。 跟 
aeons 命令 行 界面 的 做 法 不 同 ， 在 GAE 上 ， 对 Web 应 用 的 大 部 

管理 和 维护 操作 都 是 通过 名 为 Google Developer Console (开发 者 控制 
a) 的 Web 界 面 完成 的 。 虽 然 GAE 也 拥有 与 开发 者 控制 台 具 有 同等 功能 
的 命令 行 接口 ， 但 Google 公 司 的 命令 行 工 具 并 没有 像 Heroku 那 样 集成 这 
些 接口 。 图 10-3 展 示 了 Google 开 发 者 控制 台 的 使 用 界面 。 








除了 注册 账号 之 外 ， 使 用 GAE 需 要 做 的 另 一 件 事 就 是 访问 
https://cloud.google.com/appengine/ downloads 下 载 相 应 的 SDK (Software 
Development Kit， 软 件 开 发 工具 包 ) 。 在 这 个 例子 中 ， 我 们 将 下 载 GAE 
为 Go 语言 提供 的 SDK。 


eee < pD console.developers.google.com/project 


jrade your account. Only $299.49 and 54 days 
Googl Select a t 
“on cated ac ba sain in your free trial O 好 um 
Project Name Project ID Requests Errors Charges 
ws-g S a 


Projects pending deletior 





图 10-3 ”使 用 Google 开 发 者 控制 台 创 建 GAE Web 应 用 








GAE 与 其 他 Google 服 务 




















GAE 和 Google Cloud SQL 这 样 的 Google 服 务 并 不 是 免费 的 。Google 公 司 会 为 新 注册 的 用 
户 提 供 60 天 的 试用 期 以 及 价值 300 美 元 的 试用 额度 ， 因 此 读者 应 该 可 以 免费 实践 本 节 介 绍 的 内 
】 容 ， 但 是 当 试用 期 到 期 或 者 试用 额度 耗 尽 时 ， 读 者 就 需要 付费 才能 继续 使 用 这 些 服务 了 。 





















































在 安装 完 SDK 之 后 ， 我 们 接 下 来 要 做 的 是 对 GAE 的 数据 存储 
(datastore) 进行 配置 。 正 如 前 所 说 ，Google 公 司 对 直接 的 网 络 访问 有 





严格 的 限制 ， 用 户 是 无 法 直接 连接 外 部 的 PostgreSQL 服 务 器 的 。 为 此 ， 
在 这 一 节 中 ， 我 们 将 使 用 Google 公 司 提 供 的 Google Cloud SQL 服务 来 代 
PostgreSQL. Google Cloud SQL 是 一 个 基于 MySQL 的 云端 数据 库 服 
务 ， 用 户 可 以 通过 cloudsql 包 直 接 在 GAE 中 使 用 该 服务 。 


为 了 使 用 Google Cloud SQL， 我 们 需要 先 通过 开发 者 控制 台 创 建 一 





个 数据 库 实例 ， 具 体 步 又 如 图 10-4 所 示 。 用 户 首 先 需 要 在 控制 台 上 点 击 
自己 创建 的 项 目 〈《 在 这 个 例子 中 ， 我 创建 的 项 目 名 为 ws-g-1234 ) ， 接 
着 在 左 侧 的 导航 面板 中 点 击 “Storage”( 存 储 ) ， 然 后 再 选择 其 中 

的 “Cloud SQL”， 从 而 进入 Cloud SQL 的 设置 页 面 。 在 点 击 “New 
Instance”( 新 实例 〉 按 钮 之 后 ， 用 户 将 会 看 到 一 些 与 创建 数据 库 实例 有 
关 的 选项 。 这 些 选 项 中 的 大 部 分 已 经 预先 设置 好 了 ， 需 要 改动 的 地 方 不 
多 ， 我 们 唯一 要 做 的 就 是 将 “Preferred location” (Hii) 选项 设置 
为 “Follow App Engine App”( 与 App Engine 的 应 用 保持 一 致 ; ， 并 让 项 
目的 应 用 D 保 持 默 认 值 不 变 。 在 进行 了 上 述 设置 之 后 ， 我 们 的 GAE 应 用 
束 能 够 正常 访问 数据 库 实例 了 。 


需要 注意 的 是 ， 因 为 Google 公 司 默 认 会 为 用 户 的 数据 库 实例 提供 一 
个 免费 的 IPv6 地 址 ， 但 是 却 不 会 提供 IPv4 地 址 ， 所 以 如 果 你 的 早 面 计算 
机 、 移 动 电脑 、 服 务 右 或 者 你 正在 使 用 的 网 络 供应 商 并 没有 使 用 IPv6 连 
接 ， 那 么 你 还 需要 花 一 点 额外 的 钱 去 获取 一 个 IPv4 地 址 ， 并 将 这 个 地 址 
添加 到 设置 页 面 。 


3. 选择 Follow App Engine App. 






eee console.developers.googie.com/project/ws-g-1234/sq\/create y O J 
ic ws-g * Jpgrade you int. Only $299.49 and 54 days remain in your free trial A 
DS ow 
Compute 
Preferred location App Engine application ID 
App Engine 
Follow App Engine App > ws-g-1234 
Backups 
Z Enable backups 12:00 PM — 4:00 PM 
Binary log (requires backups) 
Activation policy 
@ OnDemand 
Always On 
Compute Engine Never 


Container Engine 


Networking File system replication 


@ Synchronous 
Storage 


Ch table 
oud Bigtable Asynchronous 
Cloud Datastore 


Cloud SQL IPv4 address 





Cloud Storage Assign an IPv4 address to my Cloud SQL instance. 
Big Data i 
1. 点 击 Storage， 2. 选择 Cloud SQL。 4. 设置 IPv4 IP 地 址 。 


展示 存储 菜单 。 





图 10-4 通过 开发 者 控制 台 创 建 一 个 Google Cloud SQL 数据 库 实例 





除 以 上 提 到 的 少数 几 个 选项 之 外 ， 其 他 选项 只 需要 保留 默认 即 可 。 
在 最 后 ， 用 户 只 需要 为 自己 的 实例 设置 一 个 名 字 ， 一 切 就 大 功 告 成 了 。 


也 许 你 已 经 预料 到 了 ， 因 为 GAE 平 台 是 如 此 地 别具一格 ， 所 以 为 了 
将 Web 应 用 部 署 到 这 个 平台 上 ， 对 代码 的 修改 自然 也 变 得 无 法 避免 了 。 
下 面 从 高 层次 的 角度 列 出 了 将 简单 Web 服务 部 敬 到 GAE 所 需要 做 的 一 


些 事情 ; 


。 修改 包 名 ， 不 再 使 用 main 作为 包 名 ; 


o FER main pA; 

。 把 处 理 器 的 注册 语句 移 到 init 函数 里 面 ; 

。 使 用 MySQL 数 据 库 驱 动 代替 PostgreSQL 数 据 库 驱 动 ; 
把 SQL 查询 修改 为 MySQL 格 式 。 


因为 GAE 将 接管 被 部 署 的 整个 应 用 ， 所 以 用 户 将 无 法 控制 应 用 何 时 
被 启动 或 者 运行 在 哪个 端口 之 上 。 实 际 上 ， 用 户 编写 的 将 不 再 是 一 个 独 
立 的 应 用 ， 而 是 一 个 部 署 在 GAE 上 的 包 。 这 样 导致 的 结果 是 ， 用 户 将 不 
能 再 使 用 main 这 个 为 独立 的 Go 程序 预 留 的 包 名 ， 而 是 要 将 包 名 修改 
为 main 以 外 的 其 他 名 字 。 


接 下 来 ， 用 户 还 需要 移 除 程 序 中 的 main 函数 ， 并 将 该 函数 中 的 代 
码 移 到 init 函数 。 对 简单 Web 服 务 来 说 ， 我 们 需要 将 原来 的 main K 
数 : 
func main() { 


server := http.Servert{ 
Addr: ":8@80", 


http.HandleFunc("/post/", handlePost) 


server.ListenAndServe() 


} 





修改 为 以 下 init 函数 : 


func init() { 
http.HandleFunc("/post/", handlePost) 
} 








注意 ， 在 新 的 init 函数 里 ， 原 本 用 于 指定 服务 器 地 址 以 及 端口 号 
的 代码 己 经 消失 ， 同 样 消失 的 还 有 用 于 局 动 Web 服 务 器 的 相关 代码 。 


考虑 到 我 们 还 需要 将 简单 Web 服 务 使 用 的 数据 库 驱 动 从 PostgreSQL 
切换 至 MySQL， 因 此 我 们 需要 在 data.go 中 导入 MySQL 数 据 库 驱动 ， 
并 设置 正确 的 数据 连接 字符 串 : 
import ( 


"database/sql" 
_ "github.com/ziutek/mymysql/godrv" 


) 
func init() { 

var err error 

Db, err = sql.Open("mymysql", "cloudsql:<app ID>:<instance name>*<databa 


se 
=»name>/<user name>/<password>" ) 
if err != nil { 
panic(err) 





除了 上 述 修改 之 外 ， 我 们 还 需要 将 相应 的 SQL 碍 询 修改 为 MySQL 格 
式 。 尽 管 这 两 种 数据 库 使 用 的 语法 非常 相似 ， 但 并 不 完全 相同 ， 所 以 程 
序 是 无 法 在 不 做 修改 的 情况 下 直接 运行 的 。 比 如 ， 对 于 以 下 代码 中 加 粗 
显示 的 SQL 碍 询 语 句 : 








func retrieve(id int) (post Post, err error) { 


post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = 


$1 


", id).Scan(&post.Id, &post.Content, &post.Author) 


return 


} 





我 们 将 不 再 使 用 诸如 $1 、$2 这 样 的 标识 ， 而 是 使 用 ?来 表示 被 蔡 
换 的 变量 ， 就 像 这 样 : 


func retrieve(id int) (post Post, err error) { 
post = Post{} 
err = Db.QueryRow("select id, content, author from posts where id = ?", 


mid).Scan(&post.Id, &post.Content, &post.Author) @ 
return 


} 





O 根据 MySQL 的 查询 格式 ， 将 原来 的 $n 标识 修改 为 ?标识 


在 对 代码 做 完 必要 的 修改 之 后 ， 我 们 接 下 来 还 要 创建 一 个 对 应 用 进 
行 描述 的 app.yaml 文件 ， 如 代码 清单 10-6 所 示 。 

















代码 清单 10-6 ”用 于 GAE 部 署 的 app.yaml 文 件 








application: ws-g-1234 
version: 1 

runtime: go 
api_version: gol 


handlers: 
- url: /.* 


script: _go app 
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就 是 在 这 个 文件 中 修改 应 用 的 名 字 ， 然 后 一 切 就 大 功 告 成 了 ! 以 上 就 是 
将 简 时 Web 服务 部 署 到 GAE 上 所 需要 做 的 全 部 工作 ， 接 下 来 ， 是 时 候 对 
这 个 将 要 运行 在 GAE 之 上 的 简单 Web 服 务 做 一 些 测 试 了 ! 











因为 我 们 在 前 面 对 应 用 做 了 大 量 的 修改 ， 所 以 可 能 会 有 读者 觉得 自 
己 已 经 无 法 在 本 地 的 机 器 上 运行 这 个 应 用 了 ， 不 过 这 种 担心 是 不 必要 的 
一 一 开发 者 只 需要 使 用 Google 公 司 提供 的 GAE SDK， 就 可 以 在 本 地 运 
行 自己 的 GAE 应 用 了 。 


在 按照 下 载 页 面 提 供 的 指示 安装 了 GAE SDK 之 后 ， 我 们 只 需要 在 
应 用 的 根 目 录 下 使 用 终端 执行 以 下 命令 ， 束 可 以 运行 目 己 的 GAE WebM 
用 了 : 


GAE SDK 提 供 了 在 本 地 运行 GAE 应 用 所 需 的 环境 ， 从 而 使 用 户 可 
以 在 本 地 测试 自己 的 应 用 。 除 此 之 外 ，GAE SDK 还 提供 了 一 个 本 地 运 
行 的 管理 网 站 (admin site》， 用 户 只 雷 访 问 http://localhost:8000/， 束 可 
以 通过 该 网 站 检视 自己 编写 的 代码 。 遗 憾 的 是 ， 在 撰写 本 书 的 时 候 ， 开 
发 环境 还 不 文 持 Cloud SQL， 上 所 以 我 们 还 无 法 直接 在 本 地 测试 简单 Web 
服务 。 解 决 这 个 问题 的 一 种 方法 是 在 本 地 使 用 MySQL 服 务 器 进行 测 
试 ， 然 后 在 生产 环境 中 继续 使 用 Cloud SQL 数据 库 。 








在 确保 应 用 一 切 正常 之 后 ， 用 户 就 可 以 通过 执行 以 下 命令 ， 将 应 用 
部 署 到 Google 公 司 的 服务 器 上 了 : 


goapp deploy 


在 执行 以 上 命令 之 后 ，SDK 将 把 应 用 的 代码 推送 到 Google 公 司 的 服 
务 器 ， 然 后 由 服务 器 对 其 进行 编译 和 部 署 。 如 果 一 切 正常 ， 被 推送 的 应 
用 将 如 期 地 出 现在 互联 网 上 上。 比如， 我 们 可 以 通过 http:/ws-g- 
1234.appspot.com/ 访 问 名 为 ws -g-1234 的 应 用 。 


为 了 测试 这 个 刚刚 部 署 完毕 的 简单 Web 服 务 ， 我 们 可 以 使 用 以 下 命 
令 ， 让 curl 回 服务 器 发 送 一 个 创建 数据 库 记 录 的 POST 请 求 : 


curl -i -X POST -H "Content-Type: application/json" -d '{"content":"My fir 
st 


post", "author": "Sau Sheong"}' http://ws-g-1234.appspot.com/post/ 
HTTP/1.1 200 OK 


Content-Type: text/html; charset=utf-8 
Date: Sat, 01 Aug 2015 06:46:59 GMT 


Server: Google Frontend 
Content-Length: 6 
Alternate-Protocol: 8@:quic, p=0 





现在 再 次 使 用 curl 去 获取 刚刚 创建 的 数据 库 记 录 : 





curl -i -X GET http://ws-g-1234.appspot.com/post/1 
HTTP/1.1 266 OK 

Content-Type: application/json 

Date: Sat, 01 Aug 2015 06:44:29 GMT 

Server: Google Frontend 

Content-Length: 69 

Alternate-Protocol: 8@:quic, p=0 


{ 
"id": 1, 
"content": “My first post", 
"author": "Sau Sheong" 


| 


GAE 非 常 强大 ， 它 拥有 许 许多 多 的 功能 ， 这 些 功能 可 以 帮助 开发 者 
在 互联 网 上 创建 和 部 署 可 扩展 的 Web 应 用 ， 但 因为 GAE 是 Google 公 司 开 
发 的 平台 ， 所 以 如 果 用 户 想 要 使 用 这 个 平台 ， 束 必须 遵守 这 个 平台 的 规 
则 。 





10.4 ”将 应 用 部 闭 到 Docker 


前 一 节 简 单 地 介绍 过 Docker， 讨 论 了 如 何 将 Go Web ATA A 
Docker 容 堪 并 将 其 推送 至 可 用 的 Docker 托 管 服务 上 ， 而 在 本 节 中 ， 我 们 
将 会 更 加 完整 地 学 习 Docker 的 部 普 方 法 ， 并 研究 如 何 将 简单 Go Web 服 
务 部 普 到 本 地 Docker 箱 主机 以 及 云端 的 Docker 宿 主机 之 上 。 


10.4.1 什么 是 Docker 


Docker 是 一 个 非常 了 不 起 的 项 目 ，PaaS 公 司 dotCloud 最 初 在 2013 年 
发 布 了 这 个 开源 项 目 ， 之 后 无 论 是 大 型 公司 还 是 小 型 公司 ， 都 被 这 一 项 
目 震撼 了 。Google、AWS 以 及 微软 这 样 的 技术 公司 都 在 拥抱 Docker， 
AWS 拥 有 EC2 Container Service( 容 器 服务 ) ，Google 提 供 了 Google 
Container Engine (容器 引擎 )，Digital Ocean、Rackspace 甚 至 IBM 等 众 
多 云 供应 商 也 纷纷 加 入 了 文 持 Docker 的 行列 当中 。 除 此 之 外 ， 像 BBC、 
ING 这 样 的 银行 以 及 高 盛 这 样 的 传统 公司 也 开始 在 内 部 答 试 使 用 
Docker。 


一 言 以 项 之 ，Docker 就 是 在 容器 中 构建 、 发 布 和 运行 应 用 的 一 个 开 
放 平 台 。 容 器 并 不 是 一 项 新 技术 一 一 它 在 Unix 初 期 就 已 经 出 现 ，Docker 
最 切 基 于 Linux 的 容器 就 是 在 2008 年 引入 的 。Heroku 的 dynos 同 样 也 是 一 
种 容器 。 











如 图 10-5 所 示 ， 容 器 与 虚拟 机 的 不 同 之 处 在 于 ， 虚 拟 机 模拟 的 是 包 
括 操作 系统 在 内 的 整个 计算 机 系统 ， 而 容器 只 提供 操作 系统 级 别 的 虚拟 
化 ， 并 将 计算 机 资源 划分 给 多 个 独立 的 用 户 空 间 实例 使 用 。 这 两 种 虚拟 
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速度 和 部 署 速 度 也 比 虚 拟 机 快 得 多 。 


虚拟 机 : 模拟 包括 操作 系统 容器 : 提供 操作 系统 级 别 的 虚拟 化 ， 
在 内 的 整个 计算 机 系统 并 将 资源 划分 给 多 个 用 户 空间 实例 


客户 操作 系统 


proce enone - =, 
+ 








图 10-5 “容器 与 虚拟 机 的 不 同 之 处 在 于 ， 容 器 提供 的 是 操作 系统 级 别 的 虚拟 化 ， 并 且 容 器 可 以 
将 资源 划分 给 多 个 独立 的 用 户 空间 实例 
Docker 实 质 上 就 是 一 种 管理 容器 的 软件 ， 它 的 存在 使 开发 者 可 以 更 
为 简单 地 使 用 容器 。 除 Docker 之 外 ， 市 面 上 还 存在 着 chroot、Linux 
containers (LXC) 、Solaris Zones、CoreOS 和 ]mctfy 等 一 系列 同类 软 
件 ， 但 Docker 是 其 中 名 声 最 显赫 的 一 球 。 


10.4.2 ”安装 Docker 


Docker 目 前 只 能 在 基于 Linux 的 系统 上 工作 ， 但 它 也 提供 了 一 些 变 
通 的 方法 ， 使 OS X 用 户 和 Windows 用 户 也 能 够 在 自己 的 系统 上 使 用 


Docker 的 开发 工具 。 为 了 安装 Docker， 用 户 需 要 访问 
https://docs.docker.com/engine/installation， 然 后 根据 自己 的 系统 以 及 想 
要 使 用 的 Docker 版 本 ， 按 照 说 明 安 装 。 对 于 Ubuntu Server 14.04， 我 们 
可 以 通过 执行 以 下 这 个 简单 的 命令 来 安装 Docker: 


wget -q0- https://get.docker.com/ | sh 


在 安装 Docker 之 后 ， 我 们 可 以 通过 执行 以 下 这 条 命令 来 确认 Docker 
是 否 已 经 安装 成 功 : 


sudo docker run hello-world 


10.4.3 ”Docker 的 概念 与 组 件 


如 图 10-6 所 示 ，Docker 引 擎 (简称 Docker) 包含 多 个 组 件 。 刚 才 在 
测试 Docker 安 装 是 否 成 功 时 ， 我 们 就 用 到 了 第 一 个 组 件 Docker 客 户 端 ， 
它 束 是 用 户 在 与 Docker 守 护 进 程 交 互 时 所 使 用 的 命令 行 接口 。 








i 


Docker 宇 护 进程 


Docker 容 加 


Docker € 


Dha- 


Docker 镜 像 Dockerfile 

















图 10-6 Docker4| # HH Docker? F vin. Docker 守护 进程 以 及 不 同 的 Docker 容 器 组 成 ， 这 些 容器 
为 Docker 镑 像 的 实例 。Docker 镜 像 可 以 通过 Dockerfile 创 建 ， 并 且 镜 像 还 能 够 存储 在 Docker 注 册 
中 心 〈registy) 中 























Docker 守 护 进程 运行 在 宿主 操作 系统 (host OS) 之 上 ， 该 进程 会 
对 客户 端 发送 的 服务 请 求 进行 应 答 ， 并 对 容器 进行 管理 。 


Docker is 〈 简 称 容器 ) 是 对 运行 特定 应 用 所 需 的 全 部 程序 〈 包 括 
操作 系统 在 内 ) 的 一 种 轻 量 级 虚拟 化 。 轻 量 级 容器 会 让 应 用 以 及 与 之 相 
关联 的 其 他 程序 认为 自己 独占 了 整个 操作 系统 以 及 所 有 便 件 ， 但 是 实际 
上 并 非 如 此 ， 多 个 应 用 共享 同一 宿主 操作 系统 。 





Docker 容 器 都 基于 Docker 镜 像 构建 ， 后 者 是 辅助 容器 进行 局 动 的 只 
读 模 板 ， 所 有 容器 都 需要 通过 镜像 启动 。 有 好 几 种 不 同 的 方法 可 以 创建 
Docker 镜 人像， 其 中 一 种 就 是 在 一 个 名 为 Dockerfile 的 文件 里 包含 一 系列 


指令 。 











Docker 镜 像 既 可 以 以 本 地 形式 存储 在 运行 着 Docker 守 护 进程 的 机 器 
上 《也 就 是 Docker 的 宿主 机 之 上 ) ， 也 可 以 被 托管 至 名 为 Docker 注 册 中 
心 的 Docker 镜 像 资源 库 里 面 。 用 户 既 可 以 使 用 自己 的 私有 Docker 注 册 中 
心 ， 也 可 以 使 用 Docker Hub Chttps://hub.docker.com/) 作为 自己 的 
registy。Docker Hub 同 时 提供 公开 和 私有 的 Docker 镜 像 ， 但 私有 的 
Docker 镜 像 需要 付费 才能 使 用 。 


如 果 用 户 是 在 类 似 Ubuntu 这 样 的 Linux 系 统 上 安装 Docker， 那 么 
Docker 守 护 进 程 和 和 Docker 客 户 端 将 被 安装 到 同一 机 器 里 面 。 但 如 果 用 户 
是 在 OS X 和 Windows 这 样 的 系统 上 安装 Docker， 那 么 Docker 只 会 把 客户 


wi SERRE RB, MPP ERE MI REIT, We 
一 个 运行 在 该 系统 之 上 的 虚拟 机 里 面 。 这 种 情况 的 一 个 例子 是 ， 在 OS 
X 上 安装 Docker 时 ，Docker 客 户 端 将 被 安装 到 OS X 里 面 ， 而 Docker 守 护 
进程 则 会 被 安装 到 VirtualBox〔 一 蒜 基 于 x86 架 构 的 虚拟 机 监视 器 〉 的 一 
个 虚拟 机 里 面 。 


在 此 之 后 ， 用 户 只 需要 通过 Docker 镜 像 来 运行 Docker 容 器 ， 并 将 其 
运行 在 Docker 答 主 之 上 就 可 以 了 。 
在 对 Docker 有 了 一 个 大 体 的 了 解 之 后 ， 我 们 是 时 候 来 学 习 如 何 将 


Web 应 用 部 署 到 Docker 里 面 了 。 接 下 来 的 一 节 将 继续 使 用 前 面 展示 过 的 
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10.4.4 Docker 化 一 个 Go Web 应 用 


尽管 Docker 使 用 了 那么 多 的 技术 ， 但 Docker 化 一 个 Go Web 应 用 却 
一 点 也 不 困难 。 因 为 Web 服 务 拥有 对 整个 容器 的 完整 访问 权限 ， 所 以 我 
们 不 需要 对 服务 的 代码 做 任何 修改 ， 只 要 使 用 Docker 并 进行 相应 的 配置 
就 可 以 了 。 作 为 例子 ， 图 10-7 从 高 层次 的 角度 展示 了 将 一 个 web 应 用 
Docker 化 并 部 署 到 本 地 以 及 云端 的 具体 步骤 。 


在 本 节 中 ， 我 们 将 使 用 ws-d 作为 web 服务 的 名 字 。 部 署 的 第 一 步 
是 在 应 用 程序 的 根 目 录 中 创建 一 个 代码 清单 10-7 所 示 的 Dockerfile 文 件 。 


) 创建 ) 使 用 Dockerfile \\ 根据 Docker 在 云端 创建 连接 远程 ”\\N 在 远程 宿主 中 \\\ 在 远程 宿主 中 
Dockerfile 构 Docker 宿 主 Docker 宿 主 构建 Docker 镜 像 / /启动 Docker 容 器 
i | 
| 


部 署 到 本 地 服务 器 部 署 到 云端 














图 10-7 将 Go Web 应 用 Docker 化 并 部 署 到 本 地 以 及 云端 的 具体 步 又 

















代码 清单 10-7 简单 Web 服 务 的 Dockerfile 文 件 








FROM golang @ 


ADD . /go/src/github.com/sausheong/ws-d @ 
WORKDIR /go/src/github.com/sausheong/ws-d 
RUN go get github.com/lib/pq © 

RUN go install github.com/sausheong/ws-d 


ENTRYPOINT /go/bin/ws-d @ 


EXPOSE 8080 © 





@ 使 用 一 个 安装 了 Go 并 且 将 GOPATH 设置 为 /go 的 Debian 镜像 作 
为 容器 的 起 点 


O 把 本 地 的 包 文件 复制 到 容器 的 工作 空间 里 面 
O 在 容器 内 部 构建 ws-d 命令 

O 把 ws-d 命令 设置 为 随 容器 启动 

© 注 明 该 服务 监听 的 端口 号 为 8080 


这 个 Dockerfile 文 件 的 第 一 行 告 诉 Docker 使 用 golang 镜像 启动 ， 这 
是 一 个 安装 了 最 新 版 Go 并 将 工作 空间 设置 为 /go 的 Debian 镜 像 。 之 后 的 
两 行 会 将 当前 目录 中 的 本 地 代码 复制 到 容器 中 ， 并 设置 相应 的 工作 目 
录 。 在 此 之 后 ， 文 件 使 用 RUN 命令 指示 Docker 获 取 PostgreSQL 驱 动 并 构 
建 Web 服 务 的 代码 ， 然 后 将 可 执行 的 二 进 制 文件 放置 到 /go/bin 目录 
中 。 在 此 之 后 ， 文 件 使 用 ENTRYPOINT 命令 指示 Docker 将 /go/bin/ws- 














d 设 置 为 随 容 器 局 动 。 最 后 ， 文 件 使 用 EXPOSE MEHER 45-4 8080 Siig 
口 暴 露 给 其 他 容器 。 需 要 注意 的 是 ， 这 个 EXPOSE 命令 只 会 对 同一 宿主 
内 的 其 他 容器 打开 8080 端 口 ， 但 它 并 不 会 对 外 开放 8080 端 


在 编写 好 Dockerfile 文 件 之 后 ， 我 们 就 可 以 使 用 以 下 命令 来 构建 镜 
像 了 : 


docker build -t ws-d . 


这 条 命令 将 执行 Dockerfile 文 件 ， 并 根据 文件 中 的 指示 构建 一 个 本 
地 镜像 。 如 果 一 切 顺 利 ， 那 么 在 这 条 命令 执行 完毕 之 后 ， 用 户 应 该 可 以 
通过 docker images 命令 看 到 新 鲜 出 炉 的 镜像 文件 : 


REPOSITORY TAG IMAGE ID CREATED VIRTUAL SIZE 
ws -d latest 65e8437fce6b 16 minutes ago 534.7 MB 





在 成 功 创建 镜像 之 后 ， 我 们 就 可 以 通过 运行 镜像 来 创建 和 局 动容 器 
af 


docker run --publish 80:8080 --name simple web service --rm ws-d 





这 条 命令 会 通过 ws-d 镜像 创建 出 一 个 名 为 simple_web_service 
的 容器 。--publish86:88686 标 志 打开 HTTP 端 口 80 并 将 其 映射 至 前 面 
通过 EXPOSE 命令 暴露 的 8080 端 口 ， 而 -rm 标志 则 指示 Docker 在 容器 已 
经 存在 的 情况 下 ， 先 移 除 已 有 的 容器 ， 然 后 再 创建 并 启动 新 容器 。 如 果 





不 设置 --rm 标志， 那么 Docker 在 容器 已 经 存在 的 情况 下 将 保留 已 有 的 
容器 ， ee ee 而 不 是 创建 并 启动 新 容器 。 为 了 确认 容器 是 
否 已 经 启动 ， 我 们 可 以 执行 以 下 命令 


J 


如 琳 一 切 正常 ， 你 的 容 占 应 该 会 作为 其 中 一 员 ， 出 现在 已 激活 容器 
列表 当中 : 


CONTAINER ID IMAGE ... PORTS NAMES 
eeb674e289a4 ws-d ... 0.0.0.0:80->8080/tcp simple web service 





因为 页 面 宽 度 的 限制 ， 这 里 忽略 了 docker ps 命令 输出 的 某 些 列 ， 
但 这 里 展示 的 信息 已 经 足以 表明 我 们 的 容器 现在 已 经 正常 地 运行 在 本 地 
的 Docker 答 主 之 上 了 。 跟 之 前 一 样 ， 我 们 可 以 通过 curl 命令 回 服务 器 
发 送 一 个 POST 请 求 ， 创 建 一 条 记录 : 


curl -i -X POST -H "Content-Type: application/json" -d '{"content":"My fir 
st 

post", "author":"Sau Sheong"}' http://127.0.0.1/post/ 

HTTP/1.1 266 OK 

Content-Type: text/html; charset=utf-8 

Date: Sat, 01 Aug 2015 06:46:59 GMT 


Server: Google Frontend 
Content-Length: 6 
Alternate-Protocol: 8@:quic, p=0 





现在 ， 通 过 curl 命 令 获 取 之 前 创建 的 记录 : 


curl -i -X GET http://127.0.0.1/post/1 
HTTP/1.1 200 OK 

Content-Type: application/json 

Date: Sat, 01 Aug 2015 06:44:29 GMT 
Server: Google Frontend 
Content-Length: 69 

Alternate-Protocol: 80:quic, p=0 


"content": "My first post", 
"author": "Sau Sheong" 


} 





10.4.5 将 Docker 容 器 推送 至 互联 网 


把 简单 Web 服 务 Docker 化 为 容器 上 听 起 来 是 一 件 非 常 棒 的 事情 ， 但 这 
个 容器 现在 还 只 是 运行 在 本 地 宿主 上 ， 而 我 们 真正 想 要 做 的 是 把 容器 放 
到 互联 网 上 运行 。 有 几 种 不 同 的 方法 可 以 把 Docker 容 器 部 署 到 远程 宿主 
上 运行 ， 目 前 来 说 ， 最 简单 的 一 种 方法 就 是 使 用 Docker 机 器 了 。 





Docker 机 器 (machine〉 是 一 个 命令 行 接口 ， 它 允许 用 户 在 本 地 以 
及 云端 创建 公开 或 者 私有 的 Docker 和 宿主 。 在 编写 本 书 时 ，Docker 机 器 文 
持 包 括 AWS、Digital Ocean, Google Compute Engine. IBM Softlayer、 
Microsoft Azure、Rackspace、Exoscale 和 VMWare vCloud Air 在 内 的 公有 
JEMA; 与 此 同时 ，Docker 机 器 也 文 持 在 私有 云 供应 商 以 及 运行 着 
OpenStack、VMWare 或 者 Microsoft Hyper-V 的 云 供 应 商 上 创建 宿主 。 








Docker 机 器 并 不 会 与 Docker 本 吴 一 同 被 安装 ， 而 需要 单独 安装 。 用 
户 可 以 通过 克隆 代码 库 https://github.com/docker/machine 或 者 从 
https://docs.docker.com/machine/install-machine/ 下 载 相 应 平台 的 二 进 制 包 
来 安装 Docker 机 器 。 比 如 ， 使 用 Linux 的 用 户 就 可 以 通过 以 下 命令 来 获 


得 Docker 机 器 的 二 进 制 包 : 


curl -L https://github.com/docker/machine/releases/download/v@.3.0/docker- 
wmachine linux-amd64 /usr/local/bin/docker-machine 








在 下 载 完 二 进 制 包 之 后 ， 用 户 还 需要 执行 以 下 命令 将 二 进 制 包 变 成 
可 执行 文件 : 


chmod +x /usr/local/bin/docker-machine 


在 下 载 完 Docker 机 器 并 将 它 变 成 可 执行 文件 之 后 ， 用 户 就 可 以 在 
Docker 机 器 支持 的 云端 上 创建 Docker 窒 主 了 了。 要 做 到 这 一 点 ， 其 中 最 为 
轻松 的 一 种 办 法 就 是 使 用 Digital Ocean。Digital Ocean 是 一 个 虚拟 专用 服 
务 器 (virtual private server, VPS) 供应 商 ， 它 的 服务 以 易于 使 用 以 及 价 
格 实惠 而 堵 称 〈VPS 是 供应 商 以 服务 形式 销售 的 虚拟 机 ) o Digital 
Ocean 在 2015 年 5 月 成 为 了 仅 次 于 AWS 的 世界 第 二 大 Web 服 务 器 托管 公 
Fl. 








为 了 在 Digital Ocean 上 创建 Docker 宿 主 ， 我 们 需要 先 申请 一 个 
Digital Ocean 账号 ， 并 在 拥有 账号 之 后 ， 访 问 Digital Ocean 
的 “Applications & API” 〈 应 用 与 API) 页 面 https:/cloud.digitalocean.comy/ 


settings/applications. 


410-8 zs Į “Applications & AP 页 面 的 样子 ， 访 页面 中 包含 了 一 
个 “Generate new token” (Æ RI OIE) 按钮 ， 我 们 可 以 通过 点 击 这 个 按 
钮 来 生成 一 个 新 的 令 牌 。 生 成 令 牌 时 首先 要 做 的 就 是 输入 一 个 名 字 ， 并 





勾 选 其 中 的 “Write”( 写 入 ) 复 选 框 ， 然 后 点 击 “Generate new token” (Œ 
RED 按钮 。 这 样 一 来 ， 你 就 会 拥有 一 个 由 用 户 名 和 密码 混合 而 成 的 
个 人 访问 令 牌 ， 这 个 令 牌 可 以 用 于 进行 API 寻 份 验证 。 需 要 注意 的 是 ， 
令 牌 只 会 在 生成 时 出 现 一 次 ， 之 后 便 不 再 出 现 ， 因 此 用 户 需 要 把 这 个 令 
牌 存 储 到 安全 的 地 方 。 
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110-8 在 Digital Ocean 上 生成 个 人 访问 令 牌 非常 简单 ， 只 需要 点 击 *Generate new token” iJ A] 


为 了 使 用 Docker 机 器 在 Digital Ocean 上 创建 Docker 答 主 ， 我 们 需要 
在 控制 台 执行 以 下 命令 : 





docker-machine create --driver digitalocean --digitalocean-access-token <t 
okenwsd 

Creating CA: /home/sausheong/.docker/machine/certs/ca.pem 

Creating client certificate: /home/sausheong/.docker/machine/certs/cert.pe 


m 
Creating SSH key... 

Creating Digital Ocean droplet... 

To see how to connect Docker to this machine, run: docker-machine env wsd 





在 成 功 创建 远程 Docker 宿 主 之 后 ， 接 下 来 要 做 的 就 是 与 之 进行 连 
接 。 注 意 ， 因 为 我 们 的 Docker 客 户 端 目前 还 连接 着 本 地 Docker 答 主 ， 所 
以 我 们 需要 对 它 进行 调整 ， 让 它 改 为 连接 Digital ee 
主 。Docker 机 器 返回 的 结果 提示 我 们 应 该 如 何 做 到 这 一 点 。 人 简单 来 说 ， 
我 们 需要 执行 以 下 命令 





docker-machine env wsd 

export DOCKER_TLS_VERIFY="1" 

export DOCKER_HOST="tcp://104.236.0.57:2376" 

export DOCKER_CERT_PATH="/home/sausheong/.docker/machine/machines/wsd" 


export DOCKER_MACHINE_NAME="wsd" 
# Run this command to configure your shell: 
# eval "$(docker-machine env wsd)" 





这 条 命令 展示 了 云 上 的 Docker 答 主 的 环境 设置 ， 而 我 们 要 做 的 就 是 
修改 现 有 的 环境 设置 ， 让 客户 端 指 癌 这 个 Docker 答 主 而 不 是 本 地 Docker 
TE , 这 一 点 可 以 通过 执行 以 下 命 pp 令 来 完成 : 


eval "$(docker-machine env wsd)" 


这 条 简单 的 命令 会 让 Docker 客 户 端 连接 到 Digital Ocean 的 Docker 宿 
主 之 上 。 为 了 确认 这 一 点 ， 我 们 可 以 执行 以 下 命令 


docker images 


PO 


如 末 一 切 正 币 ， 应 该 不 会 看 见 任 何 镜像 。 回 想 一 下 ， 之 前 我 们 在 连 
接 本 地 Docker 窒 主 的 时 候 ， 曾 经 在 本 地 创建 过 一 个 镜像 ， 如 末 客 户 端 还 
在 连接 本 地 宿主 ， 那 么 至 少 会 看 到 之 前 创建 的 镜像 ， 而 没有 看 见 任何 镜 
像 则 表示 客户 站 已 经 没有 再 连接 到 本 地 Docker 答 主 了 。 


因为 新 的 Docker 御 主 还 没有 任何 镜像 可 用 ， 所 以 我 们 接 下 来 要 做 的 
就 是 在 新 宿主 上 重新 创建 镜像 ， 为 此 ， 我 们 需要 再 次 执行 之 前 提 到 过 的 


docker build 命令 : 


docker build -t ws-d . 


在 这 条 命令 执行 完毕 之 后 ， 用 户 使 用 docker images 人 至少 会 看 到 
两 个 镜像 ， 其 中 一 个 是 golang 基础 镜像 ， 而 另 一 个 则 是 新 创建 的 ws-d 
镜像 。 现 在 ， 一 切 都 已 就 络 ， 我 们 最 后 要 做 的 驶 是 跟 之 前 一 样 ， 通 过 镜 
像 运行 容器 : 


docker run --publish 80:8080 --name simple web service --rm ws-d 





这 条 命令 将 在 远程 Docker 窒 主 上 面 创建 并 启动 一 个 容器 。 为 了 验证 
这 一 点 ， 我 们 可 以 跟 之 前 一 样 ， 通 过 curl 创建 并 获取 一 条 数据 库 记 
录 。 跟 之 前 不 一 样 的 是 ， 这 次 curl 将 不 再 是 问 本 地 服务 器 发 送 POST 请 
求 ， 而 是 向 远程 服务 器 发 送 POST 请 求 ， 而 这 个 远程 服务 器 的 IP 地 址 就 
是 docker-machine env wsd 命令 返回 的 了 P 地 址 : 


curl -i -X GET http://104.236.0.57/post/1 
HTTP/1.1 200 OK 
Content-Type: application/json 
Date: Mon, 93 Aug 2015 11:35:46 GMT 
Content-Length: 69 
{ 

"id": 2, 

"content": "My first post", 

"author": "Sau Sheong" 





大 功 告 成 ! 以 上 就 是 通过 Docker 容 器 将 一 个 简单 的 Go Web 服 务 部 
署 到 互联 网 所 需 的 全 部 步骤 。Docker 并 不 是 部 署 Go Web 应 用 最 简单 的 
方式 ， 但 这 种 部 普 方 式 正 在 变 得 越 来 越 流 行 。 与 此 同时 ， 通 过 使 用 
Docker， 用 户 只 需要 在 本 地 成 功 部 普 过 一 次 ， 就 可 以 毫 不 费力 地 在 多 个 
私有 或 者 公有 的 云 供应 商 上 重复 进行 部 署 ， 而 这 一 点 正 是 Docker 真 正 的 
威力 所 在 。 幸 运 的 是 ， 现 在 你 已 经 知道 该 如 何 通 过 Docker 来 获得 这 一 优 
势 了 。 











为 了 保证 本 章 以 及 本 节 的 内 容 足 够 简短 并 且 目 标 足 够 明确 ， 这 里 介 
绍 的 内 容 省 略 了 大 量 的 细节 。 如 果 你 对 Docker 感 兴趣 〈 这 是 一 件 好 事 ， 
因为 它 是 一 个 非常 有 趣 的 新 工具 ) ， 那 么 可 以 花 些 时 间 阅 读 Docker 的 在 
线 文 档 (https://docs.docker.com/) 以 及 其 他 关于 Docker 的 文章 。 





10.5 PAA Z la AAT eb 


在 结束 本 章 之 前 ， 让 我 们 通过 表 10-1 来 回顾 一 下 本 章 介 绍 的 几 种 
部 署 方法 ， 不 过 别 忘 了 ， 这 些 方法 只 是 许 许多 多 Web 应 用 部 署 方法 中 的 
几 种 而 已 。 


























表 10-1 几 种 Go Web 应 用 部 署 方法 的 对 比 
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对 于 这 和 Heroku 是 一 个 公有 | GAE 是 一 个 严 |Docker 是 一 项 非常 有 前 
新 式 的 部 署 方 ”|PaaS 平 台 ， 除 了 少 | 格 受 限 的 Paas | 景 的 技术 ， 无 论 是 公有 
评注 | 式 ， 使 用 者 需要 | 数 几 项 限制 之 外 ， | 平台 ， 使 用 者 | 的 部 署 还 是 私有 的 部 

自己 完成 几乎 所 | 使 用 者 几乎 可 以 做 | 需要 与 平台 密 | 署 ， 都 有 很 多 供应 商 可 



























































有 事情 所 有 事情 切 绑 定 供 选择 

















10.6 ”小结 





H Go Web 服 务 最 简单 的 方法 就 是 直接 将 二 进 制 可 执行 文件 放置 
到 服务 器 里 面 〈 这 个 服务 器 可 以 是 虚拟 机 ， 也 可 以 是 实际 存在 的 服 
Sar) ， 然 后 通过 配置 Upstart 来 保证 服务 可 以 随 系 统 启 动 并 持续 地 
ja1 PA 

Heroku 是 最 简单 易 用 的 Paas 平 台 之 一 ， 将 Go Web 服 务 部 署 到 
Heroku 平 台 的 方法 非常 简单 直接 ， 只 需要 对 代码 做 一 些微 小 的 修 
改 ， 然 后 使 用 Godep 生 成 本 地 依赖 关系 并 创建 Procfile 文 件 即 可 。 最 
后 ， 用 户 只 需要 将 Web 应 用 的 全 部 代码 推送 到 Heroku 的 Git 代 人 码 库 束 
可 以 完成 部 区 工作 。 

GAE 是 Google 公 司 提供 的 一 个 非常 强大 的 沙 箱 PaaS 和 平台， 这 个 平台 
的 缺点 是 部 署 方法 比较 复杂 ， 但 它 的 优点 在 于 被 部 署 的 Web 服 务 将 
获得 非常 好 的 可 扩展 性 。 

Docker 是 一 种 最 近 开 始 轩 露头 角 并 且 威 力 强 大 的 Web 服 务 和 Web 应 
用 部 署 方式 。 跟 其 他 部 署 方式 相 比 ，Docker 部 署 方式 要 复杂 得 多 。 
用 户 首 先 需要 将 被 部 署 的 Go Web 服 务 Docker 化 为 容器 ， 然 后 才能 
在 本 地 Docker 和 宿主 或 者 云 问 的 远程 Docker 宿 主 上 部 署 这 个 容器 。 





附录 ”安放 和 设置 Go 


安装 Go 


在 编写 Go 代码 之 前 ， 我 们 需要 先 设置 好 相关 的 环境 。 首 先 要 做 的 
就 是 安装 Go 语言 ， 这 一 工作 可 以 通过 下 载 并 安装 官方 提供 的 二 进 制 发 
行 版 来 完成 ， 在 需要 的 情况 下 ， 我 们 也 可 以 通过 源 代码 来 安装 Go。 在 
撰写 本 书 的 时 候 ，Go 的 最 新 版 本 为 1.6。 





Go 官方 为 release 8 或 以 上 版 本 的 FreeBSD、2.6.23 或 以 上 版 本 的 
Linux、SnowLeopard 或 以 上 版 本 的 Mac OS X、XP 或 以 上 版 本 的 
Windows 都 提供 了 支持 32 位 (386) 和 64 位 (amd64) x86 处 理 器 架构 的 
二 进 制 发 行 版 。 除 此 之 外 ，Go 还 为 FreeBSD 和 Linux 提 供 了 支持 ARM 人 处 
理 器 架构 的 三 进 制 发 行 版 。 


以 上 提 到 的 所 有 发 行 版 的 安装 包 都 可 以 在 https://golang.org/dl/ 下 
载 。 读 者 可 根据 所 使 用 的 平台 选择 并 下 载 相应 的 安装 包 ， 然 后 按照 本 文 
接 下 来 介绍 的 方法 进行 安装 。 需 要 注意 的 是 ， 尽 管 Go 语言 本 喘 并 不 依 
赖 任何 源 代 人 码 版 本 控制 系统 ， 但 是 诸如 go get 等 工具 却 需 要 用 到 源 代 
人 码 版 本 控制 系统 ， 因 此 为 了 能 够 更 方便 地 使 用 Go 语言 进行 开发 ， 我 们 
建议 在 安 北 Go 的 同时 也 安装 相应 的 源 代码 版 本 控制 系统 。 











关于 源 代码 版 本 控制 系统 的 下 载 和 安装 方法 可 以 在 以 下 这 些 网 站 上 
找到 |: 


e Mercurial http://mercurial.selenic.com; 





e Subversion http://subversion.apache.org ; 


e Git 








http://git-scm.com; 


e Bazaar http://bazaar.canonical.com. 





Linux 和 FreeBSD 


要 在 Linux 或 FreeBSD 上 安装 Go， 首 先 需要 下 载 go< 版 本 >.《< 操 作 系 
统 >-< 架 构 >.tar.gz 文件 。 比 如 ， 当 前 64 位 架构 的 Linux 安 装 包 的 名 字 
WLAN go1l.6.3.linux-amd64.tar.gz 。 








压缩 包 下 载 好 了 之 后 ， 将 它 解压 到 /usr/1local 目录 中 ， 并 将 目 
录 /usr/local/go/bin 添加 到 PATH 环境 变量 当中 。 添 加 环境 变量 的 工 
作 可 以 通过 将 以 下 代码 行 添加 到 /etc/profile 文件 
或 $HOME/ .profile 文件 中 来 完成 : 


export PATH=$PATH:/usr/local/go/bin 


Windows 


使 用 Windows 操 作 系 统 的 读者 可 以 通过 下 载 MSI 安 装 包 或 者 zip 压 缩 
包 来 安装 Go。 使 用 MSI 安 装 包 进 行 安装 相对 来 说 更 容易 一 些 ， 只 需要 运 
行 MSI 安 装 包 然 后 按照 指示 进行 安装 就 可 以 了 。 在 默认 情况 下 ， 安 装 包 
会 将 Go 安装 到 c:\Go 文件 夹 里 面 ， 并 将 c:\Go\bin 文件 夹 添 加 到 PATH 
环境 变量 中 。 


使 用 zip 压 缩 包 进行 安 六 也 是 非 第 容易 的 ， 只 需要 将 压缩 包 解 压 到 


一 个 文件 夹 里 面 ( 如 c:\Go ) ， 然 后 将 这 个 文件 夹 中 的 bin 子 文件 夹 添 
加 到 PATH 环 境 变量 中 就 可 以 了 。 


Mac OS X 


使 用 Mac OS X 操 作 系 统 的 读者 可 以 通过 下 载 相应 的 PKG 安 装 包 来 
安装 Go。 安 装 包 会 将 相应 的 Go 发 行 版 安装 到 /usr/1loca/go 目录 里 
面 ， 并 将 目录 /usr/local/go/bin 添加 到 PATH 环境 变量 中 。 在 安装 完 
成 之 后 ， 需 要 重启 终端 ， 或 者 在 终端 里 面 执行 以 下 命令 : 





$ source ~/.profile 


除 使 用 PKG 安 装 包 进行 安装 之 外 ， 我 们 还 可 以 通过 执行 以 下 命令 来 
使 用 Homebrew 安 装 Go: 


$ brew install go 


设置 Go 


在 安装 Go 之 后 ， 我 们 还 需要 对 它 做 一 些 设置 。Go 语 言 的 开发 工具 
能 够 基于 公开 托管 的 代码 项 目 进行 协作 ， 它 们 既 适 用 于 开源 项 目 ， 也 适 
用 于 其 他 项 目 。 


Go 代码 一 般 都 是 在 工作 空间 (workspace〉 中 进行 开发 的 ， 工 作 空 
间 指 的 是 包含 以 下 3 个 子 日 录 的 日 录 : 








e src 目录 ， 用 于 包含 Go 源 代码 文件 ， 这 些 源 代 码 文件 会 被 组 织 成 一 
个 个 包 Cpackage) » src 目录 中 的 每 个 子 目 录 都 表示 一 个 包 ; 

。pkg 目录 ， 用 于 包含 包 对 象 (package object) ; 

。 bin 目录 ， 用 于 包含 可 执行 的 二 进 制 文件 。 





图 A-1 展 示 了 一 个 工作 空间 的 例子 。 


工作 空间 的 工作 方式 非常 简单 。 当 编译 Go 代码 的 时 候 ， 编 译 器 会 
创建 相应 的 包 《〈 库 ) 以 及 二 进 制 可 执行 文件 ， 并 将 这 些 包 和 可 执行 文件 
放 到 相应 的 目录 中 。 如 图 A-1 所 示 ， 我 们 在 src 目录 中 创建 了 一 
个 first_webapp 目录 ， 并 在 这 个 目录 里 面 放置 了 一 个 webapp.go 文 件 

， 以 此 来 构建 一 个 简单 的 Web 应 用 。 当 我 们 编译 这 个 Web 应 用 的 源 代码 
A 编译 器 会 将 生成 的 二 进 制 可 执行 文件 放置 到 这 个 工作 空间 的 bin H 
录 里 面 。 





eee P gows 


< a gion m mv v 


pD 


Name a Size Kind 
v e bin -- Folder 
H first webapp 5.7 MB Unix E...le File 
v E pkg -- Folder 
v D darwin_386 -- Folder 
> |) code.google.com -- Folder 
> P github.com -- Folder 
> (0) darwin_amd64 -- Folder 
v & src -- Folder 
v 天 first_webapp -- Folder 
lë] webapp.go 241 bytes § TextM...cument 


10 items, 241.5 GB available 








图 A-1 Go 工作 空间 的 目录 结构 





设置 工作 空间 的 任务 可 以 通过 设置 GOPATH 环境 变量 来 完成 。 你 可 
以 使 用 除 Go 安 装 位 置 之 外 的 其 他 任何 目录 来 作为 自己 的 工作 空间 。 举 
个 例子 ， 假 如 你 想 要 将 Linux、FreeBSD 或 者 Mac OS X 中 的 $HOME/go H 
录 设 置 为 工作 空间 ， 那 么 你 只 需要 在 终端 中 执行 以 下 命令 即 可 : 


$ mkdir $HOME/go 
$ export GOPATH=$HOME/go 





你 也 可 以 通过 将 以 下 代码 行 添加 到 自己 的 ~/ .profile 文件 或 
者 ~/ .bashrc 文件 里 面 来 让 设置 一 直 有 效 : 


export GOPATH=$HOME/go 





为 了 方便 ， 我 们 可 以 在 设置 工作 空间 的 同时 ， 通 过 执行 以 下 命令 来 
将 工作 空间 中 的 bin 目录 添加 到 PATH 环境 变量 当中 : 


$ export PATH=$PATH:$GOPATH/bin 


这 样 一 来 ， 我 们 就 可 以 直接 执行 编译 后 的 Go 程序 了 。 








欢迎 来 到 异步 社区 ! 


异步 社区 的 来 历 


异步 社区 (www.epubit.com.cn) 是 人 民 邮 电 出 版 社 旗 下 IT 专 业 图 书 旗 
舰 社 区 ， 于 2015 年 8 月 上 线 运营 。 


异步 社区 依托 于 人 民 邮 电 出 版 社 20 余 年 的 开 专 业 优 质 出 版 资源 和 编 
辑 策 划 团 队 ， 打 造 传统 出 版 与 电子 出 版 和 目 出 版 结合 、 纸 质 书 与 电子 书 
结合 、 传 统 印 刷 与 POD 按 需 印 刷 结合 的 出 版 平 合 ， 提 供 最 新 技术 资讯 ， 
为 作者 和 读者 打造 交流 互动 的 平台 。 
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Python 机 着 学 习 -一 预 。 贝 叶 斯 方法 : CR 。 机 器 学 习 项 目 开发 实战 MOR SHR 
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ALD BEB AIT A ? 
购买 图 书 


我 们 出 版 的 图 书 涵盖 主流 IT 技 术 ， 在 编程 语言 、Web 搁 术 、 数 据 科 
学 等 领域 有 众多 经 典 畅销 图 书 。 社 区 现 已 上 线 图 书 1000 余 种 ， 电 子 书 
400 多 种 ， 部 分 新 书 实 现 纸 书 、 电 子 书 同步 出 版 。 我 们 还 会 定期 发 布 新 
书 书 讯 。 
下 载 资源 

社区 内 提供 随 书 附 赠 的 资源 ， 如 书 中 的 案例 或 程序 源 代码 。 





另外 ， 社 区 还 提供 了 大 量 的 免费 电子 书 ， 只 要 注册 成 为 社区 用 户 就 
可 以 免费 下 载 。 


与 作 译 者 互动 


很 多 图 书 的 作 译 者 已 经 入 驻 社区 ， 您 可 以 关注 他 们 ， 咨 询 技 术 问 
题 ， 可 以 阅读 不 断 更 新 的 技术 文章 ， 听 作 译 者 和 编辑 畅 聊 好 书 背 后 有 趣 
的 故事 ;， 还 可 以 参与 社区 的 作者 访谈 栏目 ， 疝 您 天 注 的 作者 提出 末 访 题 
Ho 








灵活 优惠 的 购书 


您 可 以 方便 地 下 单 购买 纸 质 图 书 或 电子 图 书 ， 纸 质 图 书 直 接 从 人 民 
邮电 出 版 社 书 库 发 贷 ， 电 子 书 提供 多 种 阅读 格式 。 

对 于 重 磅 新 书 ， 社 区 提供 预 售 和 新 书 首发 服务 ， 用 户 可 以 第 一 时 间 
买 到 心仪 的 新 书 。 


用 户 帐 户 中 的 积分 可 以 用 于 购书 优惠 。100 积 分 =1 元 ， 购 买 图 书 
时 ， 在 + Mm 里 填 入 可 使 用 的 积分 数值 ， 即 可 扣 减 相应 金额 。 


| Regains 


购买 本 电子 书 的 读者 专 享 异步 社区 优惠 券 。 使 用 方法 : 注册 成 为 社区 用 户 ， 在 下 单 购书 
时 输入 “57AWG”， 然 后 点 击 “ 使 用 优惠 码 ” 即 可 享受 电子 书 8 折 优 惠 ( 本 优惠 券 只 可 使 用 一 
次 ) 。 






































纸 电 图书 组 合 购买 


社区 独家 提供 纸 质 图 书 和 电子 书 组 合 购 买方 式 ， 价 格 优 惠 ， 一 次 购 
买 ， 多 种 阅读 选择 。 
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AX BT BUT A ? 
提交 勘误 
您 可 以 在 图 书页 面 下 方 提交 勘误 ， 每 条 勘误 被 确认 后 可 以 获得 100 
积分 。 热 心 勘误 的 读者 还 有 机 会 参与 书稿 的 审 校 和 翻译 工作 。 
写作 


社区 提供 基于 Markdown 的 写作 环境 ， 喜 欢 写作 的 您 可 以 在 此 一 试 
身手 ， 在 社区 里 分 享 您 的 技术 心得 和 读书 体会 ， 更 可 以 体验 上 自 出 版 的 乐 
趣 ， 轻 松 实现 出 版 的 梦想 。 











如 果 成 为 社区 认证 作 译 者 ， 还 可 以 享受 异步 社区 提供 的 作者 专 至 特 
色 服 务 。 


会 议 活 动 早 知 道 


您 可 以 掌握 1T 圈 的 技术 会 议 资讯 ， 更 有 机 会 免费 获 赠 大 会 门票 。 


AR 


扫描 任意 二 维 码 都 能 找到 我 们 : 








异步 社区 





微 信 订 阅 号 

















QQ: 436746675 


社区 网 址 : www.epubit.com.cn 
官方 微 信 : 异步 社区 
官方 微 博 : @ 人 邮 异 步 社区 ，@ 人 民 邮 电 出 版 社 -信息 技术 分 社 


投稿 改 咨询 : contact@epubit.com.cn 


